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UP TO 25% LOWER COST PER PAGE THAN LASER PRINTERS.’ 
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They fox, scan, copy and deliver laser-quality printing-at on impressively low cost 
per page. Individual ink cartridges save money too, because you only repbce what runs out. 
Hl^ PCMagazine*s Readers’ Choice for service and reliability for 15 years running. 
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HP OfficeJet Pro L7680 AiO, 
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HP OffieejetPro L7780 AiO 
Plus wireless networking. 
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$399. 


HPOFficejet Pro L7580 AiO. 

Up to 35 pages a minute. 


$299. 
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f The Mall With It All! The best selection 

The *1 Apple Direct Reseller! 

The ultimate all-in-one 

The NEWiMac! Now up to 3.06GHz! 



NEW Mac’ Pro 

■ NEW! Up to S-core performance 
with Lip to 2 Quad-Core Intel Xeon 
5400 processors at up to 3,2GHz 

■ NEW] ATI Radeon HD 2500 XT 
graphics with 256MEGDDR3 

■ NEW! Four lotemai drive bays 
support iJpto4TBofstota§e 

^2289 -75 maiMn rebate 

starting at ^2274/#737!99D 


NEW MacBook' 

■ NEW! Up to 14GHz Intel Core 1 Dim 
processor with 45nm technology 

■ NEWl U p to 25036 hard disk drive 

■ NEWIUpto23BDDR2SDRAM 

■ 13,3” glossy widescreen display 

■ soil In wireless ■ iSightcamera 

^094 -75 maihin rebate 
starting at >1019! *7404921 


NEW MacBook' Air 

■ Upto 1.B3Hz Intel Core 2 Duo 
processor ■ Only 0,76" thin 

■ Welghs|LESt3lbsJ 

'■ aOGB HD or 646B solid-state drive 

■ son In wireless ■ iSight camera 

■ 13,3" g lossy widescreen backi it LCD 

^794-noo mail-in rebate 
starting at ^ 16941*7373085 


NEW MacBook" Pro 

■ NEW] Up to 2.6GHz Intel Core 2 Duo 
processor with 45um technology 

■ NEW I Up to 6MB processor cache 

■ NEW! 17' model with arsenlc’lree 
glass and optional mercury-Free 
LED hacklir display 

^1994-M50 maiHn rebate 

starting 51^1844! *7405626 


Mac mini 

■ lntflCore2Diioprcicmr 
at speeds up to 2CiHz 

■ iGBSDfiAM ■ l)piol20GBHD 

■ SuperDrive' with dual-layer 
support or Combo drive 

■ a02.11g wireless & Gigabii Eihemei 

^594-^25 mail-in rebate 

starting at >569! *7288184 


Accessories for your Mac! 


Call or visit our Web site for the best selection of add-ons for your Mac! 
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15.4" Eclipse 
Sleeve II Laptop Case 

only ^77^^/ (7458717 



VW'Soiiic* 

20" Value Series 
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onlv >229”! ifjsoom 
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SS30 laser for Mac 

ori\y^65^^ m9B04 
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Tabiei (Black) 

Cat! fo! ether cohri! 
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#7302428 Bam boo Fun Medi u m Tablet 
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only >97”! §7449488 


Apple Time Capsule S{XX3B 

only 2941*7373106 


VMware Fusion 
• for Mac ■ — 
msmu . If 

AJfer$50n^;iFaa-fel 
rebate will Apple CPU purcliase. 

PiTce beftfe Rtote. ia $69.99. See below,t 



Apple Fihal .Cut‘ Studio-2’ 
#7236275 


Microsoft Office-i^OOiS 

^OrWlac. mmmm 

mo63oo 


Parallels Desktop 3:0 

■forMac 

m57si6 ^ WsS 


Apple Aperture"^ 2 . 
#7388599 ^ 
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ii Authorized Reseller 

ac accessories, Mac software and iPod accessories! 


Apple Universal iPod Dock 
only ‘49! #729780! 


Your iPod superstore! 


1-800-MACMALL (1-800-622-6255) www.macmall.com 

Source Code: MACTECH 


Vlad 


SI? 


(griffin) 


RoacfTrip 
FM Transmitter 
and Car charger for IPod 

only ‘47”! #684656 


Call for iPods in all colors and capacities! 
#7297622 1G8 iPod* shuffle" (Blue) 
#7404637 NEW! 2GB IPod* shuffle" (Green) 
#7297625 iPod" nano (Silver) 

#7297631 iPod* classic (Silver) 

#7373111 IPod'touchBGB 
#7373112 iPod’touch 16GB 
#7387505 NEW! IPod* touch 32&B 
"life casadoesnotipiilvtiiPad sMe. 


new low price ^47^ 
only =67^ 
stafting at"! 44 

starting at ^234 
only ^294 
only ^394 
only '^494 


Ipgitech 




r MacMall \ 
'Exclusive Deals! 

Get up to ‘200 cash back!' 
FREE Parallels Desktop 3.01' 
FREE Epson Inkjet Printer!' 

k HP At!-in-0ne Inkjet > 
Printer only *19*®!’ j/ 

See Deiow iDi detaife. 


Pure-R Elite for 

WW®/#7386397 


Pricfj Mar S70 iiHU-in refiafe flroe bafero rfbate 


NEWiMac* 


FASTER! Up to 3,06GHz Intel Core 2 Duo processor 

HEW!Upto2GB800MH2DDR2SDRAM 

Up to 500GB hard drive 

20" or 24" glossy widescreen LCD 

SXSuperDrive with dual layer 

iSight, wireless and Gigabit Ethernet 


‘Ft94^-‘50mail -in rebate 


iMac storting at 
Finance for ^36/mo, 


1144 ! 


m97733 


iFlip7” - 
Portable * 

Video Player for iPod 

only ‘49”! m87578 
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Clear Harmony V:. 
Behind-the-Head 
Stereo Headphones 

«i,39»/ musu 


Sportsuft Convertible for 
3G iPod nano 

onlv ‘24”! #7303335 



Photoshop Elements .6;o 

#7373577 


Adobe Creative Suite'3 
pesfdn Prehnium 

Catthraffordabje- . 

CSi upgrade 


MaoSpeechDlctate 

m72255 


Apple* Mac'OS'''X; 
.vIC'S.Leo'pard" 
m55254 m 


Toast;? Titan], 

m05980 ' I 
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Offer EsqjH^S SOWaS * FfiEE fWflUBi DESKTOP 3.0 CUTER-Gel f^mHeSS Oesklop 3.0 fcr Mac fflEE aflef $20 tnfir, aul 560 MacMaS maa-ln tiibiates, wias pui^bhase any new IntelrbiiiSttt ApjiJei CPU Price beJore- r^stea Is $30. Ends 6/1tSAH. ■ FFtE DffiE QFFEFlniUfer 
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^ From the Editor ^ = 

j 

/ t’s that kind of feeling you get when you're lost in a new town and a stranger points you in the right way. Or 
ilie e-mail that you get from someone who remembers the current project you're on and have sent you a 
supporting article. It’s about sharing; passing on the knowledge that you have. And that's why MacTech is here: 
to disseminate knowledge from all over to help you, the reader, do a better job, We get comments from all over, 
up and down the scale. While most say they are very happy with the magazine, some say we're too basic and 
others say we’re too advanced. 

One way to get just die magazine you’re looking for Ls to contribute. As the person responsible for finding 
authors and topics, I feel preny good about the spread of content we present each month. If there’s something 
missing, diough, please, speak up! If you can share a cool bit of technology that you’ve worked on, then write 
about it. If someone you know has something they should be sharing, prod them to write! Let us know all about 
it at editoriat@mactiech.com. 

Tills month sees the return of Kool Tools, our regular feature introducing you to applications you should 
know about. This month, Dennis SeUers reviews OmniGraffle Pro 5 and DVDxDV. 

Returning author Ben Greisler teaches us about one of the most awaited features in Leopard Server^ the Wiki 
server. As a system administrator, you need to know' more than just liow' to enable tlie service. It’s important to 
know what impacts you and your users so you can keep things amning smoodily. Ben shows the w^ay. 

Marcus Zarra gives a straightforward account of creating a menubar item. A handy way to give users status 
on processes that may have no other interface, 'Enhancing Your Application With NSStatusItem" talks about 
the topic in a way that we haven’t published previously, 

On the cover, Mihalis Tsoukalos brings us everything you need to know^ about creating a widget. 
Specifically, he shows how to create an RSS feed widget “by hand," detailing all of the moving parts. 

Dave Dribin’s Road to Code drives into deeper territory exposing Objective-C’s ability to archive objects 
Our publisher Neil Ticktin gives the scoop on the recent announcement by Microsoft that VBA will be 
coming back in the next version of Micrtisoft Office, If you rely on VBA scripting, what do you do now? We reveal 
several alternatives. (One (Option ilvai cropiied up after the article was w^ritten is the current beta of OpenOffice 3, 
which supports basic VBA scripts. You may want to investigate this in addition to the options in our article. Find 
the beta at http://download.openoffice.org/3.0beta/). 

Greg Neagle, writing for MacEnterprise, helps you plan for rolling out FileVauii in an enterprise. For a home 
user, FileVaiilt is as simple as enabling it. Flow'ever, larger organizations need to plan for its use, and Greg shares 
his tips and tricks on doing so. 

Author Norman Palardy brings us the next addition to his series on REALbasic This time he dives into the 
beginnings of a real application. 

In this month’s MacTech Spotlight, we feature Matt Giger, owner of Lunar Software. The primary product 
from Lunar Sc^ftware is EarthBrowser: a “platibrm for viewing and creating geographically based information," 
(Yes, this existed before Google Earth). Malt didn’t mention, but I w^ill, Cosmo Saver (http://www.cosmosaver.com), 
an awesome screen saver from Lunar Software that lets you drift through the Solar System, Check out MaiFs travels 
from Vic-20 to OS X developer and beytjnd. 

Mac In the Shell is on holiday this montli, and will be back next month w'itli more shell-based antics. 

Until next monlli, please, keep sharing - botli your ccxle and your thoughts! 


Ed Marczak, 
Executive Editor 
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Beginning REALBasic 

Designing the Application 

by Norman Palardy 



"N 




KEALbasic is a Rapid Application Develpnient (RAD) tool 
from REALSofm^are. In previous columns weVe looked at it 
l^riefly and even talked with Geoff Perlmann, the CEO of REAL 
Software. This inontli we’re continumg our series of articles that 
aim to get you started widi REAIbasic and show^ you how to be 
productive with it. For this series we’re using the latest version 
of RHALbasic; version 2008rL 

Designing the Interface 

In this installment we're creating an application that tracks 
tile prices of stocks. This will involve accessing the Internet to 
grab quotes, graphs and a database. Some of die components 
required are built in to REALhasic itself, and others will have to 
come from third parties. 

In diis installmeni well design die interface, die database 
and die windows weT need for adding stocks to track. Well get 
started writing the basics that make die wiiole project come 
together. 

First, start REALliasic so you have a neW' project to W'ork 
with. 



As we saw last month, tlds default project is a fully 
functioning program. You could immediately run it by pressing 
die green Run button. 


Let’s consider the tasks we’ll need to accomplish to make 
this program work the way we w^ant. 

• We’ll need a way to add and remove stocks from the list 
of ones we’re interested in. 

• It should keep quotes for any stocks we currently have, 
or had an interest in at any time 

■ WeT need a way to view die current set of stocks we’re 
interested in and dieir prices 

• Wei! need a way to get die stock prices from a 
designated source 

• Well need a way to designate which source weVe going 
to read data from 

• Eventually well want a way to grapli prices of stocks 
over time 

That’s a lot of things to consider so well tackle them one 
a! a time. Lets start widi iiow we show our list of sux*ks of 
interest. 

In die project we created earlier, there should already be a 
windtiw called Window!. Let’s start by editing that window and 
altering its layout to turn it into one that shows our list of 
stocks. 



Figure 2. Editing a REALbasic window 
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Down the left hand side is a list of the standard controls 
that are avaiiable in KEALbasic. Note that I'm using the 
Professional version. The Personal version has a smaller set of 
controls. 

In the center is the actual editor where you lay out the 
kx)k of your window. On the right is the propenies palette that 
displays the properties of the currently selected item. 

First, rename this window so that at a glance, you can 
know which window^ it is* Click the window so it is selected as 
shown in Figure 2, and then click on the Name in the property 
list on the right* Name this window wStocks. 

Then add a Listbox control to the window. Rename the 
listbox IstStocks and position and resize it so your window 
appears about like the one in Figure 3- Note that Figure 3 
shows you the position and size of my listlxjx in the properties 
palette on the right hand side. 

You’ll also notice that the listbox has several lock 
properties set (LockLeft, LockRight, LockTop, LockBottom). 
Tliese properties tell REALbnsic to keep the listbox ''locked’' to 
the respective sides of the window if the window is resized. 



Figure 3. Create the stock list window 

If you am the project at this point you wont see much 
except tliat a window^ witli a large white area .shows up. That 
area is the ILstbox, which is empty at this point. 

Tlie question, then, is how to fill it with data and what data 
to fill it with. 

Every^ control has a number of “events" that allow you 
provide custom code when something (an event) occurs. 
Different controls have different events* The list of events that 
exist for a control varies depending on what kind of control it 
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IS. Simple controls have few events. Timers only have one 
event. The listbox has a fairly long list of events. For our 
program lets start with just using the Open event. 

This event occurs when the control is about to be shown 
c}n a window that is being opened. It occurs only once when 
die window is initially opened. There are odier events that 
occur more frequently but for the start of ihLs project well use 
this event. 

One diing to be aware of Ls that event ordering is generally 
not something you want to rely on. You have no idea if die 
listbox Open event occurs before or after some other controls 
Open event. The other control may ncjt even exist yet. So you 
have to be careful about htw you use certain events and what 
you try to do in the ccxle for that event 

If you double-click the listbox you will be shown the code 
editor. REALbasic also tries to be helplul and selects the most 
likely event you are gtiing to want to edit. In this case that's the 
Change event for the list box. 



Figure 4. Editing the listbox events in the stock 
list window 

Select the Open event in the left kind pane and then add 
the following ctxle : 

me.CalumtiCotiiit = 3 // chsn^e the ttumber of vieible 

columns 

roe.HasHeading ^ true // make the list box have a leading 
rev 

me.Heading(0) = '■Symbol'* // set the heeding for the first 
column 

me.HeadingCl) = "Time" // set the heading for the second 
column 

me.Heading(2J = -$"* // set the heading for the third 
column 


Much of this CAN be done widiout writing code. If you 
review figure 3i you’ll see that in the right hand properties pane 
there are settings for ColumnCount, HasHeading and 
InitialValue. If you set the columnCount property to 3 dien the 
listbox will have 3 columns. If you check HasHeading dien tlie 
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listbox will have a heading and the setting for InitialValue will 
be used as the column headings. WeVe done these tilings in the 
Open event simply to illustrate that you can change some 
properties on the fly and they wqll take effect right away. Being 
able to alter the number of columns and their headings at run 
time will be shown in future articles. 

If you run the program now, you can see that when the 
window opens it has 3 columns witli the headings we wanted. 

Now we have a way to get the display looking like what 
we want, so now let’s see about getting some rows into it that 
display data. 

If you look up ListBox in the buOt-in Language Reference, 
you1l see it has numerous events, properties and metliods. 
Again^ an event is some piece of code tliat gets run when 
something happen; a person selects a row, clicks a button or 
presses a key Properties are the ''settings" of various aspects of 
the control; the number of columns, which row is selected, or 
other display related values like the text font and size. 

Methcxls are behaviors that the listlxjx will perform. These 
are actions like adding a row (AddRow), remove a row 
(RemoveRow), or ways to get data from the listbox (Cell and 
CellTag). 

For our use AddRow is the one we need at present. At tlie 
end of the open event add the following code . 

me.AddRow "^AAPL" // add one syml^ol we're interested In 
watching 

dim newDate as new Date // create a new instance of a 
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Date 

me.cell(me.Lastlndex.1) = newDate.ShortDate + " “ i 
newDate.ShortTime // add the date / time stamp 

me. cell (me .Lastlndex. 2) = format (169.73 JT 00''} // 
display Apple's current value 

Lets review this code closely 

me.AddRow "AAPL" // add one symbol we're interested in 
watching 

This line adds the data for the first cell (the left most one 
also known as column 0) and leaves the other cells empty. 

dim newDate as new Date 

For the second column we want die current date and dme. 
In order to get tliat information we need to create an instance 
of a Date object, which is conveniently initialized to the date 
and time from the OS wlien the instance was created. A Date 
instance is not a clock and does not automatically count 
forward. 


me.ce11(ma.LastIndex.1} “ newDate.ShortDate + " " + 
newDate.ShortTime i! add the date / time stamp 

Tlien we fill the middle cell - die one we want to contain 
the date and time - by using the CELL method to refer to a 
specific cell. Note that in order to make sure we set the correct 
cell in the correct row tliere is a convenient property called 
dastindex’' that is the row number that was last added. The 
code says *'ser the last rows cell 1 to the short date and short 
time” which is exacdy what we want. 

rne.cell{ine,LastIndex>2) = format (169.73.'*$,#.00") 

For the last column, column 2, we want a value. But the 
listlxix only knows how to display strings. So we have to take 
the current value of Apple’s stcKk, 169 73, which is a number 
and convert it into a string that die listbox can display. Also, we 
want to make sure the string that the listbox displays is 
Ibrmatied so it looks just the way we want. To do that we use 
die FORMAT method which gives us control over how numbers 
kx)k when they are converted to strings. 

Run this now and you’ll see weVe making headway. We 
can make the listbox display data, and we can add data to it. 

Next time we’ll look at how to make the data that we 
display more dynamic and actually gel it from a web based 
quote service like Yahex) finance. 
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fc e ^^rprise, Part 1 

Data security for OS X administrators 


By Greg Neagle, MacEnferprise.org 



MacEnterprise.org 

Mac OS X enterprise deployment project 


Data Security 

Data security is a hot topic in Enterprise IT these days- As 
laptop usitge increases, pushing out traditional desktops, the 
risk to company data is greater than even If a laptop is stolen 
or lost, the replacement cost of the hardware may be a pittance 
compared to the value of the data stored on the laptop’s hard 
drive. 

Therefore many companies are mandating some sort of 
data encryption for company laptops. If a laptop is then stolen 
or lost, the data would bk: inaccessible to the thief. "Whole-disk 
encryption” Is a direction many companies are moving Luward, 
but as of this writing, there are no shipping products that will 
encrypt a Mac boot volume {although some companies have 
products in the beta stage). So Mac administrators must work 
with what is available: a lechnoIog>' Apple calls ‘TileVault," 
which secures users’ home directories with AES-128 encryption. 

In part one of this series, well cover preparation and 
implementation of FileVaull in an enterprise environment. 

In part tw^o, we’II examine some of the issues you may 
encounter when implementing and supporting FileVauU in an 
enterprise environment, and techniques and tools to use to deal 
with some of these issues. 

FileVault - encryption 
for user data 

FileVault works by storing a user's files in an encrypted 
disk image file. Disk images are familiar to OS X administrators 
— many large organizations set up their OS X machines by 
restoring a disk image to the machine’s hard drive, and many 
software installers are distributed in the form of disk image 
files. FileVault uses a disk image that is encrypted with the 
user’s login password. When the user logs in, his or her 
password is used to Linlock die disk image. The image is then 
mounied under /Users/<userTiame> and for the most part, 
looks and behaves like a normal user home folder, 

dhere are two primary risks associated with implementing 
FileVault for your users. The first is tliat diey forget their 
password and cannot access their data. Since the password is 
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the same as tlie login password, this seems an unlikely 
scenario, but there are other ways a user can lock diemselves 
out of a FileVauit-protected account. It’s not uncommon for 
organizations to implement a web page that all users can go to 
change their password. If, however, a user with a FileVaulh 
protected account does this, the FileVault disk image is not 
updated with the new' password - this only happens if you use 
the Accounts preferences pane to change your password. 
Another way the password can get out of sync is if the user has 
multiple machines, and changes their password on a machine 
other than the laptop with the File Vault-encrypted home 
directory. Apple has provided a way for administrators to 
unlcKk FileVault disk images - this is tlie FileVault “master 
password”. We’ll IcKik at tlii.s later in the article. 

The second primary risk associated with FileVault is data 
corruption. Under Tiger, FileVauit-protected home directories 
are encrypted disk images, and since a disk image is a single 
file, corruption of tlrat single file can lead to die loss of the 
entire FileVault home directory. This type of corruption is rare, 
but is possible. In Leopard, FileVault now uses “sparsebundles” 
as the disk image format. This stores the disk image data in 
multiple files within an enclosing directory. Apple claims better 
performance, and importantly, better reliability, which 
presumably means that disk image corruption is even less 
likely. Your best defense against data corruption is backups. 
Backups are always important for enterpri.se data, but they are 
even more important for FileVauit-protected data. 

Preparing for FileVault 

Before implementing FileVault in your oiganization, you 
might want to do some prep work. The most important bit of 
prep work is to set die FileVault master password for all your 
machines. This is the [>assw^ord you can use to get access to a 
FileVauit-protected disk image if the user’s password has been 
forgotten or is odierwise not available. In order to be useful, 
you almost certainly wmi this master password to be the same 
on all the machines you manage. 
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10.5's Security Preference pane - FileVault tab 

To do this, you 11 create a File Vault master password on one 
machine, and then copy certain flies to all your managed 
machines. Open tlie Security preference pane and click Set 
Master Password. Since tliis will be deployed to all your 
managed machines, and since changing it {and propagating that 
change to existing FileVault-protected accounts) is difficult, 
make sure it's a non-tiivial password, and do not make it the 
same as any other admin or rc.x)t pass wind you have in use. Use 
the Password Assistant to check on the ciuality of your cht>sen 
password. 


Two new files are created in /Library/Keychains: 
FileVaultMaster.cer, and 

FilaVaultMaster,keychain - 

To implement die FiieVault master password on all the 
machines you mrinage, simply install these two files on all your 
managed machines. You can use any method to do this (put 
them in your install image, using ARD, radmind, FileWave, etc), 
but make sure they are in place before FiieVault is turned on 
for any accounts on a given machine. If FiieVault has been 
turned on before these FleVaultMaster files are installed, the 
pre-existing FileVault-protected accounts cannot be unlocked 
using the FiieVault master password you just created. 

The second most important preparation task Is to ensure 
you have a method to backup user's home directories. If you 
are using Mobile Accounts and Portable Home Directories, you 
can simply back up die network home directories on the server. 
If you can't use Portable Home Directories, you may decide to 
use something like Retrospect or Time Machine to direcdy 
backup user home directories. 

You may or may not want to implement the next 
preparation task: turning on password hints. If your users forget 
their passwords, in order to get a prompt to allow an 
administrator to unlock the account using the master password, 
Show password hints must be turned on in the Accounts 
preference pane, under Login Options, or if you are managing 
your clients via MCX, in Workgroup Manager, manage this 
Preference under Login->Login Window, checking Show 
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password hint when needed and available. One last option is 
to do this via command-line, perhaps as part of a script: 

fludo defaults write 

/Library/Preferetices/com.apple.loglnvlndow RetriesOutilHint 
3 

In Tiger, this setting is labeled Show password hint after 3 
attempts to enter a password in Workgroup Manager's 
preference management settings. 

Additionally, the MasterPasswordHint key must exist in 
the defaults keys for /Library/Preferences/ 
com.apple, loginwindow. Normally, this is set when you 
create tlie FileVault master password via the Security preferences 
pane. But if you simply distribute the /Library/Keychains/ 
FileVaultMaster.cer and /Library/Keychains/ 
FileVaultMaster .keychain files to other machines you 
manage, this key will probably not be set. 

sudo defaults write 

/Library/Preference^/com.apple.loginwindow MasterPasswordHlnt 

will do the job. (It's OK to liave an empty hint, but tlie key 
must exist.) 

Enabling password [tints is itself txjnsidered a security risk 
in many organizations, so consider if you really want to do this. 
If you doni, there is no way from the GUI ftJr an admin to 
recover a File Vault-protected home direci{)ry — but an admin 
can still do so from the command line. 

The final preparation task is training. Train your tech 
support staff on FileVault, and provide a method for your users 
to find out more about FileVault as well The better you 
document and train, the liigher users acceptance will be. 

Local preparation 

There are a fe^^ things you can do on tlie local machine before 
tumijig on FileVault tliat will increase your cxlds of success. First, 
make sure the startup disk Is healthy Run Disk Utility to verify, and 
if needed, repair the startup disk. Second, minimize the amount of 
data tliat needs to be CTjpied to the encrypted disk image - delete 
unneeded files. Empty the trash, rm -R 

/Users/username/Library/Caches/* to get rid of cache 
files. If you u.se Nonon/Symantec AntiVirus, turn off AutoProtect. 
This will .speed up creation of the new disk image and avoid issues 
where Norton AutoProtect interferes with disk image creation. (But 
lie sure to aim it back on laterl) 

Finally, make .sure there is enough free disk space on the 
.startup disk lor the FileVault conversion. Wlien FileVault is enabled 
for an account, an encrypted disk image is created, everything is 
copied from tlie "unencrypted'' home directory to die encrypted 
disk image, and finally tlie items in the unencrypted home diimory* 
are deleted. 'iTds means that you must have more free space on tlie 
liard drive dian die size of die home diiectory you are encrypting. 
If the user has 60GB of data in liis or her home directory, there 
needs to be more tlian 60GB free on the liaid drive. 


Turning on FileVault 

Turning on FileVault is straightforward. Log in as the 
user for which you'd like to turn on FileVault. In the Security 
preferences pane, click the "Turn On FileVault,,.” button. If 
the preference pane is locked, you'll be asked to enter an 
admin password (which may effectively prevent users from 
turning on FileVault by themselves). You'll then be 
prompted for the user's account password (which may 
effectively prevent admins from turning on FileVault for 
users without their involvement). You'll be presented with 
one last dialog, informing you of the dire consequences that 
await you should you forget your login password and lose 
the master password. 

WARNING: Volf are to turn on FileVault now. After your files 

ire encrvf»ted, you must enter your login ^ssword or the master 
password to ucess them. If you forget these passwords, your 
informalion wd1 be JosL 

When TfWi *um on flNVittilt. ycu wW be out wrfnle riitVflult cnciYPts yewj' 

fKhine whisti fiUghi tiilu a while Voti cvroct uw yowf ^ampuUEr whH* fhks is 
oceuiThiBL 

ither Yw turn ofl rikVAiitt. you cafinot log In to thb uwf Kcount for SNI fihe 
ih^ring or pirwTter sharing 

Us* secure tr.ase 
CUm secure virtual memory 

^ Cancel ) f Turn i^lleVaii>^ 

FileVault confirmation dialog 

New' to Leopard is the opriori to aim on seaire virtual memory 
from this dialog; in botli Leopard and llger it can also be turned on 
in the Security preference pane. Also note tlie check lx)x labled 
“Use secure erase". You should check this. If you do not, when OS 
X removes the originai home folder after creating the FileVault disk 
image, it is possible to lecover some or all of the data using an 
unerase or file resale utility. This could defeat much of the purpase 
of turning on FileVault. 

Once you click “Turn On File Vault" in this final conliniiation 
dialog, the current user will be logged out and the FileVault 
conversion process will start. If anything intemipts the logout (such 
as cancelling when asked what to do witli an unsaved doamient), 
the FOeVault conversion will be cancelled and you'll have to visit 
the Seairity preference pane to start again horn the beginning. 

If the FileVault conversion process fails for any reason, the 
partiallyKjeated encrypted disk image is removed, and die original 
home direaory is left untouched. Possible reasons for lailure of the 
FiieVliult conversion are a full liard drive; drive or file system errors 
or failures; and anti-virus scanning of die drive image. 

Automating FileVault 

New to Leopiird is tlie ability to enable FileVault protection 
when creating new accounts, or creating mobile accounts. Tills 
saves a step: you no longer have to create the account, then login 
and turn on FileVault. More importantly you c'an use MCX policies 
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to enforce FileVault so tliat it is automaticaDy turned on for all new 
mobile and local accounts. 

Enforcing FileVault on mobile accounts is stmightforward 
using Workgroup Manager. There is a new^ checkbox in Mobility 
preferences under Account Creation Options, labeled Encrypt 
contents with FileVault. 

Apple doesn't make errfordng FileVault for local accounts 
quite as easy to discover or implement, but it is possible. 

hi Workgroup Manager, choose a Computer or 
ComputerGroup to manage, dick the Preferences icon in the 
toolbar, then select the Details pane. Click the button to add a 
new preference domain. Navigate to /Applications and 
doubleclick on tiie System Preferences app. 

You should now liave the com^apple systempreferences 
domain available to you, and it should look like this: 

PrefefeiKti _ 

1 Ov«rview V- 


Madifv ippfkatiim prdcfences In preference editor; 


r-T«« . 


i 

J eiutioDth 

coni.atM>ie.MCXfity«tooih | 


Dash beard 

com.d pple.das hboard 


DeskTop Pictyre 

com.appleylesklap 


Deck 

corrv.apple.dock 


Fo^deir Redirection 

com-apple^MOtRedkector 


Home Sync 

com.apple.homeSvnc 


iCai 

com.apple.iCaE.rnanaged 


iChit 

com. ippleJChaT.Managed 

IL 

Imemfti Confl^yratiort 

com.apple. rnternet 


iTones 7 

com. apple. (Tunes 


iWork Regiitrstion 

com .apple. iWorkOS 


Kerberos Login 

ed u .in i^t.Kerberos.Kef bermLog m 

ji 1 

Mail 

com. apple, mail .managed 

V 1 




Preferences details in Workgroup Manager 

Double-dick the entry for com.apple.systempreferences, and 
delete all tlie imported keys - we don't w^mt any of them. Turn 
down the Always dictionary, and add a new key like tliis: 


confT.tppfe.svs^tempreTefences 

Wnr Keif Delete Sex Default Ocleie limnsidMd 


hiinw 

Tlfpe 

Velue 


^Once 

dicbDnBTv 

vricf't 


^ Often 

iltakirvr 

E^TB5Hl 


T Atifayi 

PicWiwy 



cam.eppie.pretefenceaecn)oraiifciroeFVFQcMewUBeni 

bool# an 

1 »ue 

* 



Done Apply 


Managing €om.apple.sy5tenipfeferences keys 


Save your changes. 

Once the updated management settings become 
available on your managed client machines, you1l see that 
when creating a new local account, the Turn on FileVault 
protection checkbox is pre-selected, and disabled so that it 
cannot be deselected. All new local accounts will 
automatically have FileVault turned on as they are created. 


hiew Account: [ Standard 

i _ j 

Short Name j 

Passwond: ' [ [?] 

Verify: | i 

Password Hint: I 

tnecom mended) | 

y^Turn on PileVault protection 
M Use secyre virtual memory 

@ Cancel^ f Creator ^ 

FileVault enforced for local accounts 


To be continued... 

We’ve prepared our infrastructure, enabled FileVault on 
existing user accounts, and looked at options for enforcing 
FileVault for all new accounts. In part two of this series, 
well look at some issues you and your users might 
encounter, and what you can do to manage these issues. 
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VBA’s Coming Back 
Is it right for you? 









VBA coming back is great, but it’s not here yet, 
and even so, it may not be your best solution. 


V 


by Neil Tickfin, Editor-in-Chief/Publisher 



Should You Read This Article? 

First off, if you don’t know wli^u VBA, scripting, or other 
types of automation are, tliis article Ls probably not useful for 
you to choose your path with Microsoft Office. In all 
likelihood, in your decision to upgrade or not to Microsoft 
Office 2008, you should look at other criteria such as features, 
I'lenclimarks, compatibility, new file types, etc... to make your 
decision. For example, you may want to kx)k at MacTech’s 
ixmchmarks tbr Office 2008 fhttp://www.mactech.com/ 
a rtkIes/madech/Vol. 24/24.03/Office2008Benchmark/) 

When you are ready tbr it, you may want to Icxik at 
scripting Office. It’s a great way to automate things that you 
do often, improve your work flows, and be more efficient on 
the types of tilings that you do all the time. 

For those you that know what VBA, AppleScript and/or 
scripting are about, youll want to read on to determine which 
path makes the most sense for you. 

Whether you are interested in scripting or not, you should 
first decide wdiether the new* features or other benefits of 
Office 2008 for Mac are imptirtant to you. You'll want to have 
that in mind as you look at your scripting options. 

Why VBA Went Away 

Sometimes, even when you want to do something, they 
are just plain hard and you can't. That’s the situation that 
Microsoft faced when they realizied there wasn’t enough time 
to ship Office 2008 for Mac, and still liave it include VBA. 

Office 2008 was a monstrous task — or better said — a 
monstrous three tasks to take on. First, die Office code base 
needed to be moved from Metrowerks CodeWarrior to Apple’s 
Xcode (these are the development environments that they 
create the programs in). Second, Microsoft needed to make 
Office 2008 “universal” (i.e., make it run natively on both Intel 
and PowerPC Macs). And, finally, they needed to complete all 


the new features, new file formats, and Office 2007 
compatibility requirements (die type of things diat they do on 
every Office upgrade). 

Each and every one of these diings was a big task in and 
of iLself, and unlike previous major versions, Microsoft had to 
do all diree at once. 

So, when it came down to the decision of whether to 
included \T5A or not in Office 2008, the answer was clear. 
They could not support VBA, or they could delay shipping 
Office 2008 for a long while (possibly as much as a year or 
two), but Microsoft would not be able to ship Office 2008 in a 
reasonable lime frame ami support VBA in that version. 

MacTech beiives that less than iO')^) {probably less than 
5%) of Office users use VBA. A.ssuming tJds is correct, the VBA 
decision was an easy one. It had to be left out. 

Don’t get us wTong, VBA i.s imponant in Enterprise 
settings — and there’s a whole lot of Office users in the 
Enterprise setting. Furthermore, VBA is the cross platform 
solution used by a lot of people even outside the large 
corporate setting. And, while AppleSaipt is lietter for many 
solutions, it's not cross platform. 

VBA is coming back, but it’s not 
tomorrow 

As you've now probably heard, Microsoft has delivered 
some good news for VBAers ... VBA is coming back, But, 
before you do cartwheels in the hallw^ay, realize tliat it’s not 
going to be tomorrow'. It’s still a ways off. 

As we said before, it’s clear that Microsoft could not make 
any decision other than dropping VBA for Office 2008. A 
huge delay would have impacted a great deal more people, 
and was a far greater pain. But, if nothing else, Microsoft has 
proven to be good at listening and evolving. They could hear 
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the pain that people felt missing VBA, and theyVe been 
looking at the possibility of implementing VBA in the next 
major release of Office. (For those of you that don't read tea 
leaves, Microsoft has been very clear over the past year that 
they do not want to wail four years for between major 
releases, as was the case between Office 2004 and Office 2008. 
Prior to that version, typically versions were 2 to 3 years 
apart.) 

Microsoft understands the importance of providing a road 
map early on, even though we’re not particularly used to it in 
the Mac market. Now that they’ve made the decision, they are 
letting the community know^ well in advance so you can plan 
accordingly. 

Your Choices 

Knowing that VBA is coming back has expanded the 
choices that you have in dealing with scripting Office. We’re 
going to focus on how you can zero in on what is the best 
choice for you for today’s use. 

For Office on the Mac, you have two basic choicest 
AppleScript and VBA. AppleScript support in Office 2008 is 
beefed up quite a bit from 2004. And, VBA is only available 
in Office 2004, and will come back some point in the future 
...in the next major release of Office for Mac. 

Both AppleScript and VBA have their strengths and 
weaknesses. VBA is cross platfcirm, but is limited to just 


scripting Office applications, and does nc^t include 
Entourage. AppleScript allows you to control Mac OS X as 
well as other Mac applications, is considered to be easier to 
learn, but is not cross platform. 

Some are served best by staying with VBA in Office 
2004. Others are better off rewriting their scripts in 
AppleScript. And, still others are better off using Office 
2007 for Windows under a virtualization product like 
VMware Fusion or Parallels (or even booting into Windows 
With Bootcamp). 

One thing you need to assess is the level of VBA 
compatibility that you may need. For most people, Office 
2004 VBA was more than enough compatible with the 
version of VBA in recent versions of Office for Window^s. 
Some, however, may require a greater level of compatibility 
in order to access new features in the Windows version of 
Office. But, generally, those people are experts in VBA 
usage, and know exactly what they need. If you aren’t sure 
about your needs, chances are the level of compatibility in 
Office 2004 will suit you just fine. 

With the announcement that VBA is coming back, you 

need to balance the question of re-writing scripts in 

AppleScript, or waiting it out with a temporary solution. 

The easiest way to figure this out is MacTech’s “Office 
Scripting Advisor'’ flow chart which asks you questions to 

hone in on the right solution for you (See Figure 1, 

following the article). 
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ISV Support, Excel Solver and 
Other Add-Ins 

One of the effects by VBA not being in Office 2008 is 
suppon for Independent Software Vendors (ISVsJ that work 
with Office. These tend to be solutions for specifically 
targeted or niche markets, but are important nonetheless. 

Some of these third party products are based on VBA, 
while others are based on the plug-in architecture. Microsoft 
has been looking at those solutions that worked before, but 
have issues with Office 2008. In some of the most important 
cases, there are solutions coming. 

One common example is Solver (an add-in for Excel) 
which is used in a number of academic and otlier settings. 
Those who upgraded to Excel 2008 found that Solver was no 
longer .supported. As of right now, there's no definitive answer 
on how this will be play out, but we can tell you tfiat Microsoft 
is working to resolve this, and similar issues. 

For those third parties basing their products on Office, 
there are two solutions. If you need 2008 suppon today, you 
may want to use AppleScript to control Office in your product. 
In the future, you'll have both VBA and AppleScript, and your 
choice will become which scripting language suits your needs 
best. And, you should keep an eye on what Microsoft does 
with tlieir SDK offerings for the products you want to support. 

What To Do 


- Professional, Fast, Dependable 


Now that you have an understanding of what the future 
holds for Office scripting, you can choose the right solution 
based on your needs. Today, you have a number of options. 
In the future, you1l have an optimal set of choices that will suit 



you even better. 

In the end, if you did not find some specific reason to the 
contrary while reading this article, then you likely fall into one 
of two groups: 

* Office 2008 with AppleScript does what you need 

* A combination approach of using both Office 2004 (for 
VBA usage) and Office 2008 for other usage works best 
for you. 

Whatever your situation, you now have a layout of what 
scripting Office looks like today, and tomorrow. 
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The Road to Code 

by Dave Dribin 


One for the 
Archives 

Archiving objects 
and document-based 
^gppiications _ 

One Year Later 


objects^ along with the relationship between the objects. An 
object graph can be represented as a diagram showing each 
object, with arrows indicating relationships. For example, if 
we have an NSMntableArray object that contains three 
Rectangle objects, the object graph would look like Figure 
1. The arrows point from the array to the rectangles because 
the array maintains a reference to each of its members. 
Often, an object graph contains one object that is at the top 
of the graph caOed the root objeci. In this case, the array is 
the root object. 



Rectangle 


Rectangle 


Rectangle 

JeftX^O 


JeftXsO 


jaftx s 0 

_bottomY = 0 


_botlomY = 0 


^bottom Y = 0 

_height = 5 


.height = 10 


_height = 20 

width = to 


width = IS 


width = 30 


This is the thirteenth article in the Road to Code column: 
happy one-year anniversary! We’ve covered a lot of ground 
in the last year, but weVe still got the pedal to the metah 
There's plenty of pavement left to cover! 

In last month's article, 1 said that we'd talk more about 
HSTableView in this article, but IVe decided to put that 
topic off for a bit. This month weVe going to cover 
document-based applications, which includes how to save 
and open - or load - custom file types. 

Document-based applications are a class of Mac OS X 
applications that aOow the user to create, save, and open 
documents. Since this is a common type of application, 
Cocoa provides a lot of the common architecture, or 
plumbing, to minimize the amount of code the developer 
has to write. 

Archiving 

Before we talk about the user interface help that Cocoa 
provides for document-based applications, weVe going to 
start from the back-end and talk about saving and loading 
objects. The Foundation framework provides a mechanism 
for converting a collection of objects to a sequence of bytes 
called archiving. Once we have the objects as a sequence 
of bytes, these bytes can be stored on disk or even sent 
across the network. To recreate the collection of objects 
from the sequence of bytes, you can use a mechanism called 
unarchiving. In Java, this conversion of objects to and from 
bytes is called serializaiion. 

Before we get into die nitty-gritty, we need to cover 
some more terminology. A collection of objects has a fancy 
name called object graph. An object graph is a coOecdon of 


Figure 1: Simple object graph 

Recall from the article about inheritance, You Have Your 
Mother’s Eyes, that Objective-C has a concept called a 
protocol. As a quick refresher, protocols are just like class 
interface declarations, except that there are no instance 
variables. Protocols also have no implementation. Other 
classes may implement protocols, and these classes must 
provide implementations to all required methods. Protocols 
are used to ensure a class implements a set of methods* 

Encoding 

Foundation's archiving and unarchiving works on object 
graphs. Not all objects may be archived, however, Only 
objects that implement the NS Coding protocol may be 
archived and unarchived. The NS Co ding protocol is shown 
in Listing 1. 

Listing 1: NSCoding protocol 

iSprotoco NSCoding 

■ (void) encodeWithCodei:: {NSCodei: *) coder: 

- [ Id] InltWitliCDder ; (NSCoder ')dcccider: 

$end 

The encodeWithCoder: method is used for archiving 
while initWithCoder: is used for unarchiving, You1f 
notice that both of these methods use a class called 
NS Coder* NSCoder and its subclasses are responsible for 
the actual transformation to and from bytes* An example 
will help clear this up* Let’s modify our Rectangle class 
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to work with archiving. The most recent interface for 
Rectangle from the last article is shown in Listing 2. 

Listing 2: Rectangle interface, without 
NSCoding support 

tfiinport <Foundation/Foiinda1:ion 

©interface Rectangle i ^3S0bJect 
I 

float _leftX; 
float 3ottDiiiY: 
float 

float height! 


iproparty float leftX: 

©property float bottomY; 

©property float widthi 
©property float height: 

©property (readonly) float area; 
©property (readoniy) float perimeter; 


©interface Rectangle : NSObject <NSCodiiig> 

The rest of the header file stays the same. We must now 
implement encodeWithCoder : and initWithCoder : or 
else the compiler will warn us about an mcompJete 
implementation. This warning is very helpful and one of the 
benefits of statically typed languages. Okay, so how do we 
implement these methods? Let's start with archiving and 
encodeWithCoder:. 

When encodeWithCoder- is called on your object, 
you need to save all your vital instance variables by encoding 
their values in the coder. Vital instance variables are all 
instance variables that cannot be calculated in any way. For 
our Rectangle class, all four instance variables are vital, 
and we must encode them all Our implemeniaiion would 
be: 

* (vpid) encodeWithCoder: (NSCoder 0 coder 
( 


• (id) 


©end 


initWithLeftX: (Hoat) leftX 

bottoml; (float) bottomY 
rightX: {float) rlghtX 
topY: (float) topY: 


[coder encodeFloat: 
[coder encodeFloat; 
[coder encodeFloat: 
[coder encodeFloat; 


I 


.laftX forKey; ©"leftK"] ; 
.bottomY forKey; ©"bottomY"]; 
.width forKey; ©''width"]; 
^hsiight forKey; S'height") : 


Since Rectangle's superclass, MSObject^ does not 
implement the NSCoding protocol, the first step is to tell the 
compiler that we want to implement the NSCoding by 
changing the ^interface declaration: 


We encode each of our instance variables, one by one, 
using the encodeFloat: forKey: method of NS Coder. 
We are using a variant of encoding called keyed encodmg. 
Keyed encoding associates each value with a string key, or 
name, similar to how NSDictionary maps keys and 
values. All keys in an inheritance chain must be unique. 
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This means your key must not only be unique to all your 
encoded values, but also to any of your superclasses' 
encoded values. The simplest way to ensure this is to use 
the name of the instance variable. I tend to leave off the 
underscore prefix, but that's just old habit. Separate 
inheritance chains can reuse keys. For example a Bitmap 
class that inherits from NSObj ect could also encode values 
using the width and height keys without conflict from 
Rectangle. 

There are encoding methods for all primitive types and 
for other objects that implement the NS Coding protocol. 
Many of the classes in the Foundation framework such as 
strings, arrays, and dictionaries implement NSCodingso you 
should be able to easily encode all of your instance 
variables. Don't forget that if your superclass implements 
NSCoding, you must call encodeWithCoder: on the 
superclass before you encode your instance variables to 
make sure that all of its instance variables are encoded, as 
well: 

- (void) encodeWithCoden (HSCoder *) coder 
1 

[super encodeWithCodert coder]; 

IL.. 

I 

As a side note, NS Coder does allow encoding values 
withoLii keys, called non-keyed encodings however t!iis 
method is no longer recommended. Keyed encoding was 
introduced in Mac OS X 10.2 and non-keyed encoding 


should only be used for legacy applications that either need 
to run on or interoperate with old versions of software. 
Since we are writing an application for Mac OS X 10.5, we 
only u.se keyed encoding. 

To use this method, we need an NS Coder instance. 
NS Coder is an abstract class, meaning that you cannot 
create instances of it directly; rather, you should use one of 
its concrete subclasses. The main subclass for encoding is 
NSKeyedArchiver, and ty^pically, you use one of its class 
methods that do all the hard work for you: 

Reci;an&le rectangle = 

NSData * data ^ 

[NSKeyedArchiver archdvedDataWithRootO'hject: 
rectangle]: 

The NSData cla.ss is part of the Foundation framework 
and it holds a sequence of bytes. Once you have the 
rectangle represented as an NSData instance, you can write 
it to disk or send it over a network. 

Decoding 

Now that weVe covered archiving objects by encoding 
objects with an NSCoder instance, we need to go the other 
way around. Unarchiving objects takes a sequence of bytes 
and creates new instances of the encoded objects. To 
support unarcliiving, our class must implement the 
initWithCoder: method. For our Rectangle class, 
there are no real surprises. We must decode each instance 
variable using the same key we used for encoding: 
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- fid) initWithCoder: fNSCoder *) decoder 

t 

self “ [super iuit]T 
If (self = nil} 
tettira nil: 

_leftX ” [decoder decodeFLoatForKey: 1 efts’"]; 

^bottanY = [decoder decodeFlnatForKey: fi^bottoniY”] : 
_widtb = [decoder decodeFlnatForKey: t'Vidth/*] ; 

_height = [decoder decodeFloatForKey: ^''height’'] ; 

return self: 

) 

Note that this is a constiuctor method and thus creates a 
new instance of our object. Since our superclass is 
NSObject and it does not implement NSGoding, we just 
call init. However, if your superclass also supports 
NSCoding, be sure to call inltWithCoder: instead: 

' (Id) itiitWithCoder: (NSCnder ’) decoder 
1 

self = [super InltWithCoder: decoder]* 

//... 

t 

While you can decode tlie keys in any order, it’s 
imperative that the keys match up between your encoding 
and decoding. Also, if you decode any objects, you must 
remember to retain them if you keep strong references to 
them as the decodeOb jectForKey: returns autoreleased 
objects. Of course, if you are using garbage collection, you 
don’t have to worry about the retains. 


To unarchive objects from a sequence bytes created with 
NSKeyedAr chive r, you should use the 
NSKeyedUnarchiver, which is also a concrete subclass of 
NSCoder, It havS a convenient class method to unarchive an 
object direcdy from an NSData instance: 

NSData * data = . . ♦: 

Rectangle * rectangle ^ 

[NSKeyedUnarchiver unarchiveObjectWithDatai 

data]: 

Now that our Rectangle class fuOy implements the 
NSCoding protocoh we can convert instances of our class to 
a sequence of bytes and back again. 

Archiving objects has many uses. For example, Interface 
Builder nib files are really just archived objects. The object 
graph for your entire GUI is created by Interface Builder and 
saved as a nib file. When your application runs, the objects 
are unarchived and ready to use. We will also be using this 
new ability to create custom rectangle documents using a 
document-based application. 

You may be wondering what happens if we add or 
remove instance variables to our rectangle class? And what 
if the new'er rectangle class needs to read archives saved by 
the older rectangle class? The way to handle this is with a 
technique called versioning. Versioning is a bit advanced to 
cover in full here, but I ju.si wanted to let you know that it is 
possible to handle this situation. Head Apple's developer 
documentation for full details. 
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Document-Based Applications 

As 1 mentioned above, many applications allow the user 
to create and edit documents, and then save them to and 
open them from disk. Since this is such a common type of 
application, Cocoa provides an architecture to help with the 
common tasks of managing documents. Applications chat 
utilize this architecture are called documenl-hased 
appHcatiom. The three classes that make up this 
architecture are NSDocument, NSWindowController, 
and NSDocumentController and are Found in the 
Application Kit framework, along with all the GUI classes 
such as WSView and NSControl, 

For simple cases, yt)U generally don't have to interact 
with NSWlndowController or 

NSDocumentController, However, you must always 
subclass NSDocument to implement saving and loading. 
WeVe going to walk through a simple document-based 
application that allows a user to save and load rectangle 
data. 

Xcode has a project template for docu mem-based 
applications, so weYe going create a fresh project from this 
template. Select File > New Project.,, from Xcode and 
choose a Cocoa Document-based Application from the New 
Project assistant, as shown in Figure 2. Click Next, and 
create a project named Rectangles in the directory of your 
choice. Finally, enable garbage collection by modifying the 
project's build settings. 


New Project 
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Figure 3: Generated files 


Figure 2; Creating a document-based application 

If you take a look at the Groups & Files list for this 
project, you'll notice that it is slightly different than the non- 
dtx'ument-based applications we’ve created so far, as shown 
in Figure 3- First, it creates a subclass of NSDocument 
called HyDocument for us in the Classes group. Second, it 
creates tw'o nib files in the Resources group: MainMenu.nib 
and My Document, nib. 


WeVe previously only used a single nib file that 
C(jniained botli the main menu and the single application 
window. Because we can have multiple document windows 
open, we use a separate nib file for document windows. 
Kemember that nib files are archived windows, views, and 
controls, so every time a new document window is created, 
Cocoa's document architecture unarchives MyDocument.nib 
to create a new window. The MainMenu.nib file only gets 
loaded once at application startup and contains only the 
menu bar items. 
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You can already run the application as-is, but it’s quite 
limited. First, the window contains a nice message that you 
are supposed to add your own controls to it. Also, saving 
and loading are not implemented, and you get an error if 
you try and save. You can, however, create new documents 
using File > New or Command-N. 

Creating the User Interface 

WeYe going to start by making the document window 
look just like the window of our Hello World application. 
Figure 4 shows the final result. Open My Document, nib 
with Interface Builder and layout the controls and 
formatters like we did before. Also setup the proper 
resizing springs and struts. (See last month's article if you 
need a reminder of how to do this.) 

#4 ^ O Rectangle 


Rectangle Width; 

--T 

Rectangle Height; 

Rectangle Area; 0 
Rectangle Perimiter; 0 

r Calculate ^ 

^ 


Figure 4: MyDocumenLnib window 


The MyDocument class takes the place of 
HelloWor Id Controller from the previous articles. It 
contains all the outlets and actions for the window. Add 
outlets for the four text fields, a calculate action, and an 
instance variable for a single rectangle, as shown in Listing 
3: 

Listing 5: MyDocument-h 

#ijiiport <Cocoa/Cocoa .h> 
edass Rectangle; 

©interface MyDocument : KSDocument 

f 

IBOutlet NSTextFleld * _widthField; 

IBOutlet NSTextField * _beightField; 

IBOutlet MSTextFleld • _areaLabel: 

IBOutlet NSTextFisld * ^petimlterLabel; 


Rectangle * ^rectangle: 

I 


‘ (iBActlon)calculate:{id)sender: 
@end 
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Now save My Docu merit.h, and go back to Interface 
Builder. Connect up the outlets and actions to the 
appropriate controls. The Filers Owner is setup to be our 
document class^ MyDocument, so use this when connecting 
the outlets and actions. 

Now, add the Rectangle class that we modified to 
support NSGoding protocol above to this project. In 
MyDocument, change the inlt method, and add the 
calculate: and updateAreaAndPerimeter methods 
to match this: 

- {id)lnit 

I 

self “ [supec init] : 
if [self — nil) 
teturn nil: 

_rectangle " [ [Rectangle alloc] initWithLeftX: D 

bottontY: 0 
rlghtX: 5 


return self: 


* [void)updateAreaAndPerimeter 

I 

[^areaLabel aetFloatValue : _i:ettangle .areal: 
LperitniterLabel setFloatValue: 

_rect3[iglG.perimeter] : 

) 


- (IBAction)calculate:(id)sender 
[ 

_rectangle.width = [_vfidthField floatValue] : 
_recta3igle.height = L_teigbtFleld floatValue] r 
[seif updateAreaAndPeriineter] : 

I 


This creates a new rectangle instance in the constructor 
and also implements the calculate: action. Remember, 
though, that we needed to implement the awakeFromNib 
to ensure the text fields and labels were correct on 
application launch. For NSDocument subclasses, you 
override the windowControllerDidLoadNib: instead 
of awakeFromHib. Their purpose is very similar, though, 
and allows you to execute code after the outlets and actions 
from the nib have been connected. Modify the supplied 
stub implementation to match this: 

- {void)windowCQUtrollerDidLoadKih:{KSWiudowController *) 
aControllur 

I 

[super WindowControllerDidLoadNiblaController] ; 
[_widthField setFloatValue: _rectangle.width]j 
[ heightField setFloatValue: _rectatgle.height] : 

[self updateAreaAndPerinieter] : 

J 

Now buOd and run the application. You should see a 
window similar to Figure 5. The initial width should be five 
and height should be ten. If you change the width or height 
and press the Calculate button, the area and perimeter 
should update accordingly. 
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Figure 5: Running document window 


This works like our first Hello World application, 
However, you can now create new' windows with the File > 
New menu. We now* want to implement saving and loading 
of documents. 

Registering File Extensions 

In order to identify our new file types, we need to come 
up with a new file extension. Since our document contains a 
single rectangle, let’s use “.rectangle” as our file extension. We 
need to tell the operating system that our application can load 
and save files with this extension. Hiis is done by editing the 
properties of our application. Open up the Targets group in 
the Groups & Files section of the project. Double click on the 
Rectangles target to bring up the Info panel for our 
application. Change to the Properties tab of the Info panel. 

There are a couple of impcKtan! properties we need to 
change. First, we need to change the identifier. Identifiers 
must be unique for every application released on Mac OS X. 
Tile recommended way to do this uses so-called reverse DNS 
notation. DNS is how websites are named. For example, my 
personal website is at www.dribin.org. The technical name for 
this website address is the DNS name. DNS names are unique, 
i.e, there is one and only one dribin.org out there. Reverse 
DNS takes advantage of the uniqueness of website names. tCs 
called reverse DNS because you list die components in the 
opposite order that you use them for websites. The default 
value is com,yourcompany. Rectangles, %vhich may be fine for 
testing, but you should really change it to a properly unique 
name. 

Let’s change it to 

org,dribin,dave,mactech.jul08,rectangles. 

Next, we need to change the document types for our 
application. The Document Types list should already have 
one document type in it. Edit it .so that the name is Rectangle 
File and that the extension is rectangle (do not include the 
period). The final result should look similar to Figure 6, 


i 

{ Gengrai Suild Rules [ Properties \ Com mem 

Executable: ^StEXECUTABIX^NAMEt 
Identifier: ^ o rg .d dbi n . dave. m actec h .]u t Ofl. rectan g I as 
Type; j APPL ' Creator: \777? j 
Kon Fik: I I 

Version. 1.0 


Principal Class: NSAppMcatioo 
Main Nib File: Main Menu 

Documem Types: 

Nanie UT\ Extensions ' 

Rectangle File rectangle _ ■ 

Figure 6: Application properties 

Tliese application properties are stored in a file called 
info,plist. You oin see tliis file in the Resources group. This file 
gets included along with your built application. How this works is 
lieyond tlie scope of tills article, hut suffice it to say tot 
applications on Mac OS X are really directories with a special 
.stnicture emailed handles. We will talk more alxiut bundles in a later 
article. 

One word of warning: I fmd tliat whenever 1 change the 
application’s properties t}r Info.plist file, I need to force Xcode to 
ttbuild tlie whole applic'ation. You do tills by using the Build > 
Clean All Targets menu item, defining removes all files generated 
during tlie build process. By cleaning the target, you force the next 
!>yilcl to rebuild everytliing. Be .sure to dean your project before 
proceeding. 

Saving and Loading 

Witli our file exteasion in place, we can now prexeed to 
implement saving and loading of rrfctangle files. The MyDociment 
dass already contains ,stub methods for saving md loading that w’e 
need to fill in. Saving Is handled by to dataOfType: error: 
methcxi!. You are suppexsed to return an NSData representation of 
your document, and the document architecture will take care of 
writing it to a file. Tlie dcifault implementation returns nil and sets 
an error. 

Tlie only data we need to save is our _rectangle iastance 
vailable. Since the Rectangle class now implements the 
NSCoding protocol, we can use an NSKeyedArchiver to 
convert our instance variable into NSData: 

- (MSData *)dataOfType: (NSString ')typeNajiie 
error:(NSErrot '*)outError 

NSData * rectangleData ^ 
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[NSKeyetJ Archiver 

arehlv&dBataWitbRootObj e<it; _rec tangl e ]: 
return rectangleData: 

I 

In Older to krad rectangle files, we need to impiement the 
readFroiiiData:ofType:error: method. We can use 
NSKeyedArchiver to amveit the supplied NSData to an 
NSRectangle and store it in our instance variable: 

- (BOOL) readFromData; (NSData ‘ )data 

ofType:(NSString *)typeHame 
error:(NSError * *)outError 

[ 

_ret: tangle = [NSKeyedtJnarcliiver 
unarchiveObjectWithDataidata]: 

return YESr 
I 

If you ate not using garbage collection, be sure to release 
the old reaangle and retain the new one. 

Witli tliese two metliods implemented, you should lx able to 
save and ojxn rectangle files. Give it a shot. 'Hie files should have 
the ‘;iectitngle” extension we setup, too. You am even double click 
on saved rectangle files in the Finder, imd it should automatically 
launch our application. As always, the completed projea may be 
downlcxided from the MacTech website. 

Well, thafs pretty mudi all tliere Ls to a document-based 
application. Due to the document arcliiteaure, tlieie's really not 
tluit miidi extra code to v^Tite comparecl to non<locument-based 
applications. Our MyDocument class is very' .similar to the 
HelloWorldController we wrote earlier. We just needed to 


add methods to save and load files, and thafs really easy if die 
classes to be saved can lx archived. 

Given that we only had to implement two extra methods, we 
get a lot of functionality “for free'’ from the Cocoa document 
architecture: 

A file open sheet is created when the user chooses File > 
Open*., 

A file save sheet is created when tlie user choose File > Save 
or Save As... 

Saving and loading to and from disk is liandled automatically 

The window title chcinges to the name of the document 

The document-based architecture really shows how Cocoa 
helps the developer write applications faster witli less code. You 
can also get undo support easily, but that will have to wait for a 
future article. 
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from within a Dashboard Widget? 

by Mihalis Tsoukalos 



Article Overview 

A Dashboard Widget, named “GetRSS"’ Widget, that 
uses the RSS technology, is going to be programmed in this 
article using JavaScript, CSS and HTML code as well as some 
PNG image files. 7’he *'GetRSS" Widget uses the 
XMLHttpRequest object from the JavaScript programming 
language to get data from the MacTech RSS feed and present 
it in a Dashboard Widget fashion. 

Because of the unknown amount of the incoming RSS 
data, this Widget needs to include a scroll bar-a 
forthcoming article is going to fully present the scroll bar 
technique. For the purposes of this article, only RSS-related 
material is going to be explained. 

Also, the presented Widget has a backside! Combining 
two or more techniques is relatively simple as long as you 
already know how to use each one of them in isolation. 

What is RSS? 

RSS (Really Simple Syndication) is a Web content 
syndication format. RSS is a dialect of XML (Exlensihle 
Markup Language) and all RSS files must conform to the 
XML 1.0 specification. It is extensively used by news 
websites, weblogs and podcasting. The RSS protocol 
transfers information in an XML file format that is called RSS 
feed, RSS stream, webfeed or RSS channel. 

Two most important advantages of RSS are that the RSS 
information is transferred as plain text, and that you can use 
a news aggregator to automatically get the updated 
information. 

A news aggregator is a category of software that can get 
RSS feed information and present it to the user Aggregators 
trim down the time and effort required for frequently 
checking the websites you want for updates. Using an 


aggregator you can subscribe to an RSS feed that it will 
check for new content at user-determined intervals, and 
retrieve the new conteni without further human 
intervention. 

The following is a small part of RSS code, taken from 
MacTech^s News RSS: 

(http://WWW. moctech,com/news/mactech.rss): 

<?xml version”*'! , 0" encoding”'*tJTF • S'*?> 

<!- generator='*wordptess/l *5" -> 

<rss versioti=''2 *0" 

xinlns!content““http://purl.org/rss/l.0/modules/content^" 
xmlnfi :wfw=''http : / / we 11 formed web * org/CominentAPI/ " 
xmlnsi dc=''http : //pur 1 .org/dc/elements/I * 1/" 

> 

<channel> 

<title>MacTech News</title> 

<!- 

[ tlini:] ] t [IpLp blaginfo_rss {*url') ?]] [[/link] ] 

’Clink>http://www .mac tech, com/</ll£ik> 
<descripi;ion>HacTech News is the source of newsn 
Information, updates and special offers specifically for 
the Mac technical cotamunlty, (/description) 

<pubBate>Fri, 14 Mar 200B 14:30;3l -0300</pubDate> 
<generator>http://wordpress.org/?v=i,5</generator) 

<Ianguage)en</language) 

(Item) 

<title>0WC Announces Mercury Elite-AL Pro 
FirewirsrtJSB2 1TB Drives</title> 

<link)http://www.mactech.com/news/?p=l010258</link) 

<coiiinients)http: //www. mac tech, com/news/?p=101025 B#comnients< 
/comments) 

<pubDate)Fri, 14 Mar 2008 06!30:31 -0300</pubBate) 
(dc;creator)Admlnistrator</dc:creator) 
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<cate^Dry>Brea.k±ng News</category) 

<guid>http ^ //wWh mactech ^ com/news/7p=1010258</guid> 
<description><! [CMTA[0WC ANNOUNCES NEW HERCUKY 
ELITE-AL PRO FIREWIRE+USE2 1 TE STORAGE DRIVES 

=45ast, Economical FireWlre+USB 2-0 Corobo External Drive 
Solutions Feature 

New Oxford 934 Chipset and the Latest SATA Technology 

Woodstock, IL, March 14, [,..]]J></description) 

<wfw:commentRSS>httpt//www.mactech*Gom/news/wp- 
coraiiientsrss2 . phpTp^l 010253 </wfw: comroentRSS) 

</itein> 

<iteti3> 

<title>New Take Control Ebook Helps Switch from PC 
to Mac</title) 

<link>http: //wwy ►inactecb*coTn/n€ws/?p=1010257</link> 

<coffiments>http: / / www .mactech. com/news/ ? p=1010257/fcDiEJDents< 
/comments) 

The listing above will help you understand the RSS feed 
format. The first line dictates that you are using XML version 
1.0 with UTF-8 Unicode character encoding. The second and 
third line tells that you are using RSS version 2,0 code that 
is created using the WordPress semantic personal publishing 
software (line 2). The other lines tell you where you can 
find the definitions of the various standards. You can also 
find out that each entry (or record) is included inside the 
<item> tag and consists of the following tags: <title>, <link>, 
<coraiiients>, <pubDate>, <dc:creator>, <category>, <guid>, 
<description> and <wfw:commentRSS>. You will later have 
to decide which of the information you want to include 
inside your Widget's output. 

Which files compose the 
complete GetRSS Widget? 

The files that compose the GetRSS Widget are the 
following: 

1. Info.plist; a file necessary lor every Widget. 

2. GetRSS.html: the main HTML file for the "GetRSS" 
Widget. 

3. GetRSS.js: the JavaScript code needed for the 
^‘GetRSS" Widget. 

4. GetRSS.CSS: the CSS file needed for formatting the 
Widget. 

5. Two image files called Default.png and Icon.png. 
Every Dashboard Widget has these two graphics files. 
The Icon.png file .should he 82x82 pixels and is 
displayed in the Dashboard Widget Bar, 

6. Some other files and directories that will be shown 
later on. 

The Info.plist file 

The contents of the Info.plist file are the following: 

<?xJiiI version="1.0" encQding=”UTF-&*"?> 

ODOCTYPE plist PUBLIC *•-//Apple Cotnptiter//DTD PLIST 
1,0//EN" 

•"http: //www.apple, com/DTDs/PropertyLlst-1.0 >dtd"> 
(pliat version='’l ,0") 


MOMH 


<dict> 

<key>AllowNetworkAecess</key> 

<tE:ue/> 

<key>BackwardsComp3tlbleClassLookup</key> 

<true/) 

<key>GFBundleIdentifier</key) 

<String>com.iiitsouk.widget. getrss</string) 
<kBy>CFBundleNanie</key) 

<strlng>GetRSS</string) 

<key)GFBundleShortVersionstring</key> 

<String)2.0</string) 

<key>CFBundieVersion</key> 

<string>200</string) 

<key>CloseBoxInsetX</kGy> 

<integer>8</integer) 

<key.>CloseBoxInsetY</kGy> 

<integer>7</Integer) 

<key>MainHTNL</key> 

(string)GetRSS,html</string) 

</diet) 

</plist) 

The GetRSS.html file 

4’he contents of the GetRSS.html can be found in the 
archive for this article at ftp.mactech.com/src/ 
mactech/volume24_2008/24.07,sif. It should be noted that 
the GetRSS.html file acts as the glue that connects all the 
other Widget files. It is also easy to understand that the 
GetRSS.html file contains uncomplicated HTML code. Most 
of its code is typical and is included in every Widget that 
uses certain Dashboard features. 

The GetRSS.css File 

The contents of the GetRSS.css file can be found in the 
source archive for this column found at 
ftp.mactech.com/src/mactech/volume24_2008/23.07.sit. 
The CSS code may look big and complexj but this is not the 
case. Most of the CSS code is standard for widgets, and is 
repeated in every widget that has a backside and a scroll 
bar. 

The GetRSS.js File 

The GetRSS.js file is the most important file of the 
whole Widget. A small mistake in it and the Widget will 
either misbehave or not work at all. Its contents are also 
in the archive for this article. Later in, ''Explaining the 
Technique/ wuJl further explain the technique and you 
will better understand the JavaScript code. 

Before continuing wdth the rest of the article, I will 
have to tell you a little problem that I had with this 
particular Widget. 1 first wrote this Widget irsing Mac OS 
X 10,4 and it worked fine. When I got the Mac OS X 10.5 
DVD and first cried the Widget, it did not w^ork as 
expected. When I pressed on a link, the link was not 
working. The following JavaScript code (the output of the 
r/i^LFNIX utility) shows a small modification that I made 
for the Widget to work: 
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< widget,openURL (div,the_link): 

< 1 else document.location = div.the^linkj 

> widget ►openURL(div. getAttril>ute( 'the_link* J) ; 

> I 

> else 

> document. location = div* get Attribute (‘tlie_l ink'); 

It turns out that the divJheJink code was not working 
as expected in Leopard. I had to use 
div^getAttributeCtbeJink') instead for the Widget to work. 
In Tiger, those notations were, more or less, equivalent. 

The full list of the “GetRSS” 
Widget files 

The following is the full list of the files that compose 
the "GetRSS” WidgeL 


drwxr-xr-x 
-rw-r— 

-rw-r-r- 
-rw-r—r— 

-rw-r— 

-rw-r-r— 
drwxr-xr -X 
-rw-r—r— 


AppleClasses 
Default.png 
GetRS S.css 
GetRS S.html 
GetRSS *]s 
Icon.png 
Images 
Info.plist 


./AppleClasses: 
AppleAnimator.js 


AppleButton.j s 
ApplelafoButton.js 
AppleScrollArea.js 
AppleScrollbar.js 
Images/ 

./AppleClasses/Images: 
scroll_thuiDb_hleft, png 
sc roll_thaiiib_hmldi. png 
scroll_thutDb_b.rlght. png 
scroll_thuinb_vbottom. png 
s c roll_tbuinb_vml d. png 
scroll„tbumb_vtop.png 
scrDll_track_hieft.png 
scroil_track„hiiiid .png 
scroll_track_hright*png 
s c r 0 1i_t ra ck_vb ottora.png 
3croll_t rack_vi]iid. png 
scroll_track_vtop.png 
slide_thumb.png 
slide_track_hleft.png 
sli(le_track_h!nld. png 
slide_track_hright.png 
slide_track_vbottom.png 
slide_track_vjnld. png 
sHde_track_vtop, png 

./Images: 

Backside.png 
background.png 
dark,png 
light.png 
top.png 
well.png 



SUPPORT TICKETS 






The Bear Essential for 

System Consistency 


Making 

Computers 

Reliable. 


Once you deploy Deep Freeze tn your Ma^ 
computing environment, you'll be amazed at thi 
difference it makes. Your computers will enjo: 
total system protection without restricting use 
access. With every system restart. Deep Freeze 
ensures Macs are returned to their original state 
providing complete system consistency whib 
offering flexible options for saving user data. 


Maybe Too 
Reliable. 


Cornputers run trouble-free, users enjoy a clear 
and reliable computing session, and personnel ar* 
liberated from tedious helpdesk requests. Tha 
leaves IT free to work on the bigger, mon 
important issuesHust don't get caught sleepmc 
on t he job. 






^ Download a free, fully 
functional evaluation copy at 

www.faronics.com 


For mors mformation csit us at 1-800-943-6422 


Versions available for 


Faronics' Sg 


IT DEPARTMENT 
































other World Compuiina 

SthwI/Corporm^ Punhase^ Ordwi accepted mth appnvtit crvdVc. 

Serving the Mac Universe since 1988 Visit: www.mac 5 ales.com or Call: 800.275.4576 


At owe Our Customers Come 1 st! Quality Products ^ i^^^ompetitiv^Pricesl 



Seagate 


[ Pnemiffl-Pnrtnar 


UPGRADE or ADD 
a new hard drive! 

Get more storage capacity (up to 1,0T8 per HD bay), more 
performance, and other benefits too with a hard drive 
provided by OWC*! Today's drives don't simply offer more 
capacity, but are much faster, quieter, and use less power 
than drives from just one year ago. If you've had your Mac* 
for more than a year or two - you wifi be amazed at what a 
new drive can do for its overall performance. 


External Storage Solutions wiviv.mocso/es.com/shop/fifevv/re/ 

Award Winning Solutions from OWC & NewerTech' btMi L A Y E R S ^ «i« C 3 l A m 

Quality, Performance, RellabtEity make OWC St storage the best you can buy. ffff IM.IjJ ' flit ^ i I VVVV bBH Hi ^ 



SERIOUS STORAGE 


owe Mercury 

FrraWife 800 + USB 2.0 Removable Bay Solutions 

ItfealfM apfiliGiions f^fulrlng hi^ ckta threugtiput, ( 3 pfl<iiy 
jfld fl^xIblEliy, 

' Hardware RAID. SoftRaid, JSOD options 
■ User custom liable configurations 
. Available with FireWire 800/400, USB 2,0, 
and eSATA interface support 
* Up ID4x 1OTB Performance Hard Drives 



MAXimus* 

RAID 1 FireWire SOO/400 + USB 2.0 

High-Performance RAID 1 ■‘MIRROR'SoiinJm provides "Live Antivity" backup/ 
daiiS redundJiKy of [^our oitkal ddlawilb Plug arid skiopllcltjf. 

* Dp 10 TOTB -I-1 OTB Dual E>rlve IMirrored) 

■ FireWire B00/40O+USB 2.0 

■ Dp Id 64MB of drive cache {S2MB per drive} 

* Ultra-protective shodi Isolation system 

* Custom (Mord 924 Based Bridge Solution 


owe Mercury On-The-Go™ 

Highest Capadty Portable Solution on the Market! 

Sa^ly and Corneniently fra^^sp^rt Large AmcHinrs of Data with No AC 
Adapter Iteeded! Single to"Tr^Fe lnlerfaa!"mndefii availablf. 

* Compact I.S 'IW) X 5.S"(D} X riH) size 
' Bus Powered or may be powered with AC adapter 
' Ultra-prntertwe shock isdation system 
‘ Custom high performance Oxford Bridge 
' Up to 50OGS 72O0RPM and IfiMB data buffer 


Hard Drives 



3.5" SATA l/H 
Up to 1.0TB 


2.5” SATA 
UptoSOOGB 1 

OGSror $ 97.99 




2.5" IDE/ATA 3.5" IDE/ATA 

Upto2SOGB 

ISDGSFor $ 75.99 


iviviv./Tiacsotes.com//iar£/drfve 


SuperDrives® and Blu-Ray 

Create or backup with Apple* IDVD*. Apple DVD Player, Apiple DVD Studio^, Apple iMovie^, Apple OI$c Burner, 

Apple IPhoto*, EMC* Retrospect*, Apple iTunes*, Rexio* Tpast*. Prosoft Ertglrieering* Data Backup 3, and NTT Dragon Bum*. 


www.macsales.com/superdnves 

S 2 SStl-»H^ 



External SyperDrives 
USB 2.0/FireWtre 
from $77.99 

Internal and External 
Blu-ray Solutions 
from$1S9i99 


Learn more about OWC's new 
'Green' Headquarter^. 

Con»rv»tlori & riiciiyclirHj foe isrrwrDW 

http;//w ww.m a esa le s .com/ LEE D/ 


Mewtfrfi^L-h. 

Mt-iuvyCJP 


•rod Tracipitidrtt of Newer fpLhrKita^y, inc. PWC jkiU OWt'! logp flite regjstered rrad^iUsrk'i imri 
liF’r'Mifhl CompuNrigiif!' iritdt'rnrtrM rrfOliH'f Worlel Computing.ptfier marki muy br? th^ 
t ih^rrowr^rs. PTiOSI.fpi’r.irrrjilkinv'Anii JVailsbltiry ar^^UbjcrCI Coi^rigp wrthgRjl noifico. 


Internal Supen 

AppI 

from 

1 

laptops 

1$9^9 














































LEOPARD 
READY! 


AUTO RESUMING DOWNLOAD 
BUILT-IN FTP CLIEN 
ENCRYPTED P2P FILE SHARIN 
COMPLETE BROWSER INTEGRATIO 
FULL IDISKCONNECTIVt 
AND MUCH MOR 


SPEED DOWNLOAC 


THE FASTEST MAC OS X DOWNLOAD MANAGE 

PLUS A WHOLE LOT MORE 


YAZSOF 




21 DATTRIAL GET ITTODAH 
WWW.YAZSOFT.COI 


NOTE: You can find the JavaScript files contained in die 
AppleClasses directory of the Widget inside the 
/System/Library/WidgetResources/AppleClasses/ directory. 
You will also find the ./AppIeClasses/Images directory along 
with its contents there. 

Figure 1 shows the image files that can be found inside 
the ./Images directory of the Widget. 
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Figure 1: The images of the ./Images directory 


The files found inside the AppJeClasses/lmages 
directory of the Widget are provided by Apple and can be 
found in 

/Developer/Applications/Dashcode.app/Concems/Resources 
/AppleClasses/Images/ on a Leopard system-provided that 
you have Dashcode installed. 

Explaining the technique 

The most challenging part of this Widget is the 
GeiRSS.js JavaScript file. The following function, called 
loadO does the necessary initializations of the JavaScript 
objects. 

function loedO 

I 

scrollbar = new 

AppleVertical Scrollbar (document .getEleBientBy Id (’'iiiyScrollBa 
r-))r 

scrollArea ^ new 

AppleScrollArea (document. getEleraentByld (‘^contents’*) , 
scrollbar): 

scrollArea.gcrollsHorlzontally = false: 
scrollArea.singlepressScrollPixels ^ 15: 

whitelnfoButton “ new 

ApplelnfoButtontdocuiaant. getElementByldt “flipper"), 

dociimeiit. getElementByld ("f ront'') I "white'", 

showBack): 



















Your email program does 
not have one of these: 



Imagine an email program that was smart 
enough to observe and learn how you handle 
your email. Like offering to reply to certain 
types of email messages using a response 
you’ve previously sent. Or giving you the 
option to auto-file a message you've read 
based on how you've filed similar messages in 
the past. What if you could defer a message 
from your inbox for a few days or weeks, so that 
it magically reappears later when you’re ready 
to deal with it? What if this program had an 
amazing junk mail filter that would leave your 
inbox devoid of spam? What if this program 
was as familiar and easy to use as Apple Mail? 


After three years in development, we've 
finally created that program. Outspring Mail 
is the newest email client for Macintosh. 
We've taken the best features of existing 
email programs and coupled them with our 
patent-pending intelligent functions to 
create a program that will make your email 
chores far easier. And since this is a 
current-generation application, it supports 
major email protocols including POP, IMAP, 
SMTP and SSL. It also runs natively on the 
latest Macintosh computers and OS X 
Leopard. But don’t just take our word for it. 
Check out the details at www.outspring.com. 


Outspring Mail. For those who take their email seriously. 


li 


outspring 




Universal 


^outspring 

5331 Skylane Blvd 
Santa Rosa, CA 95403 

707-523-7711 
http://www.outspri ngxom 


02003 Outspring Inc All rights reserved. Outspring is a registered trademark of Outspring Inc Madntosh is a registered trademark of Apple Inc 










glassButton “ new 

AppleGlassButton (dociinietit. getElementByld (“doneButton"} ^ 

* showFront): 

window^onfocus = function () i scrollArea.focus[}j ) 
window,onblur = functioti [) ( scrollArea^bliir () ; J 

if (I window.widget) 

showO : 



An anention-grabbing JavaScript function is the show() 
function which is defined as follows: 

function show () 
f 

var now “ (new Bate).getTlme(): 

f / only check if 15 minutes have passed 
if ({now - last_updated) > 900000) 

I 

if (Kml_i:eq-ueat !" null) 

( 

xml^request.abort 0 : 
xiiil_request ^ null; 

XMl_request = new XMLHttpRequest() ; 

Kml_request.onload = function(e) Uml_loaded(e* 
xml_request);] 

3 !niil_ re quest, averrldeMimeType {"text/xml'*) ; 
xnil_reqiiest I open ("GET" . feed .url) : 


xial_req’Ueat ,setRequestHeader("Cache-Control" . 

"no-cache"); 

xml_request.send(null): 

1 

1 

The 900000 time value-lt represents the minimum 
refresh time value-is in milliseconds and is therefore 
equivalent to 15 minutes (900000/1000 = 900 seconds. 900 / 
60 = 15 minutes). Then^ a new XMLHttpRequestO object is 
defined. This object holds the RSS feed data after is 
processed by the xmLloadedCe, request) function. The 
xmLloadedCe, request) function extracts the data from the 
required RSS feed fields using the following JavaScript code: 

fort var item = channel,firstCMld: item != null; item “ 

item.neKtSibling) 

i 

if( iteni,nodeNaiiie = ‘item" ) 

[ 

var title “ findChild (item, ‘title'); 

// we have to have the title to include the item 
in the list 

if( title !” null ) 

I 

var link = findChild (item, 'link'); 
var pubDate = findChild (item, 'pubDate'); 
results[results.length] = 
ititle:title,firstChild,data, 

link;(link != null ? 
link.firstChild.data ; null)♦ 
date:new 
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DateCDate , parse (pubDate . firstChild,data.)) 


I 

I 


The above J<waScnpt code parses the RSS feed and 
mines the wanted information. It only looks for the <item>j 
<title>, <link> and <pubDate> tags and their respective data. 
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version 1.5. 



Figure 3: The backside of the Widget 


It is also both interesting and educational to look at the 
ciickOnTitleCevent, div) function definition that introduces 
the widgetopenURLO function. 


Figure 2: The ^'GetRSS" Widget look 


functlDH cllckOnTitle(eventf div) 
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if (window.widget) 

f 

widget. opetiURL (div. getAttribute (‘ the_llnk ’ ) ) : 

] 

else 

document,lonetion = div,getAttribute(’the_link'); 

I 

The widget-openURLO method opens the given URL in 
the (defaiiltj web browser which resides outside Dashboard. 

Inside the JavaScript code you saw some alertO function 
calls which are the best technique for debugging Widgets. 
alertO output is written to the Console. Please remember to 
remove your alertO function calls when you finish 
debugging or otherwise your Console logs may become too 
crowded. 

Conclusions 

Using a Widget to read RSS feeds is a very valuable 
tcchniquej especially now that Widgets are getting more and 
more popular. It is also an efficient way of keeping a close 
eye on an RSS feed without having to open a dedicated 
browser windows Finally, please note: The RSS-related code 
of this article is heavily based on the “Sample RSS” Widget 
code that is provided by Apple in the 
'VDeveloper/Examples/Dashboard/Sample RSS” directory of 
a Tiger system. Strangely enough. Leopard doe,s not have the 
VDeveloper/Examples/Dashboard” directory with the 


Widget examples. Also note that the “Sample RSS” Widget 
does not have a backside. 
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Introduction 


The user interface is arguably the hardest pan of any 
application. This is especially true on OS X because we, as 
users, demand more of the developers of our applications. If 
the developer adds too many features and LIT elements, then 
the application feels too busy or complicated. However if too 
few^ features are added then application is too primitive or 
simple. 

Fortunately there are some choices. An application that 
would he considered too simple for the Dock might be perfect 
on the Dashboard or on the Menu Bar. Likewise, an 
application that is too busy to be a Dashboard widget might 
very well be perfectly at home in the Dock. But what if you 
are in the grey area between die Dock and the Menu Bar? 
While the design choices between these options ischoices 
between these options are beyond die scope of diis article, 1 
will present how to add a Menu Bar item - also known as a 
menu extra, menu item or menulet - to to your application and 
how to control it. 

Menu Bar Items: Two Different 
Beasts 

There are two different kinds of objects that can be placed 
on the menu bar in the upper right corner. First there is the 
kind diat only Apple is allow^edallows. Tlie API is private and 
at the time of this article, third party developers are discouraged 
from using them. 

The second kind that developers are encouraged to use is 
the NSStatusItem API. The NSStatusItem behaves decidedly 
different dian the internal API that Apple uses. First, 
NSStatusItem objects cannot be dragged around the menu bar; 
second they cannot be removed from die menu bar with the 
mouse; and lasdy, they are more ‘^sluggish"’ than the Apple 
internal items w'hen another item on the bar is moved or 
removed. 

However, they are still an extremely useful UI element that 
can be utilized to great effect. The basic concept behind them 


is that diey are a menu with an icon. In that respect, their 
behavior is very similar to NSMenuItem objects. 

Building an NSStatusItem 

While it is possible to build an NSStatusItem 100% in ccxle, 
I prefer to use Interface Builder wherever whenever possible, 
Tliis makes localizations easier and reduces the amount of code 
1 need to maintain. Therefore, the first step to building an 
NSStamsltem is to build its menu in Interface Builder. 

Building the Menu 

To add a new menu to the project, I open the 
MainMenu.xib file and drag in a new NSMenu object (See 
Image 1). 1 normally rename the new menu to '"Status Menu” 
or something similar to keep it clear which menu is which. 



Image 1 : Drag a new NSMenu into the ntb 
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Project 
Management 
with 
a bit of 
Magic! 


When an NSMenu is first added it contains three menu 
items. These items can be added to, removed from and 
changed as needed. For this example, I have changed the 
menu so that it has four items: Status, a separator, About and 
Quit, When I am done the menu looks like Image 2. 


Status 

About 

Quit 

Image 2: The finished menu in IB 


Just three out of hundreds of features: 

Network-based Project Management 

Collaborate with others on the same 
project over the network. Just with a 
single mouse click. 


Now that die menu itself is complete it is time to write some 
cxxle. F(m- tills example, the AppDelegate of my project will be 
respoasible for tlie NSStatiisItem. Fiist, the header: 

AppDelegale.h 
Hinport <Cocoa/Cocoa.h^ 

Winterface AppDelegate : NSObject I 
NSStatusItem ^niyStatusItein; 
iBOutlet NSWenu 'layStatusMervu: 

IBOutlet NSMenuIten ^injrMeiiQStstusItetn; 

1 



Automatic sync to iCal 

Sync your projects to iCal and then 
^ onto your iPhone or any other 
mobile device. 


Professional Cost Calculation 



ProjectWaards 

Merlin 2 is built from 
project managers for 
project managers. 


Get your free demo version 
www.merlin2.net 


Define Budgets top-down or bottom 
up and compare them to planned vs. 
actual costs. 


Since lx)th the alx^ui menu item and the quit menu item can 
be handled outside of the AppDelegate in ihis example, 1 have not 
added IBAction metliods for tliem Once the header has been 
written, it is time to go back to Interface Builder and link tlie 
references as shown in Image 3- 

As for tlie Afxjut ;ind Quit menus, they am linked to the 
Application objea as follows: 

About -> NSApplioaiion -orderFrantStandardAboutPanel: 

Quit -> NSAppIication -terminate: 

Once all of die linking is complete, 1 am dcme withwith the 
worit with Interfirice Builder Ls complete;. tTime to move on to die 
AppDelegate. In this situation 1 prefer to initialize the NSStatusItem 
in the applicationDidFinishLaunching: method so that it appears as 
soon as the application Is ready to start receiving events. 
Depending on an appQcaiions particular situation the initialization 
cxxle can lie placed in other locutions. 

A^Dekgate.m 
import **AppDelegate. h” 

@iiipleraentation AppDelegate 


(void) applicatlonDidFiniflhLautiching: [NSKotification* )nQtificatio 
n 


toy Statue Item = [ [ [NSStatusBar systemStatusBar] 
statuaIteiiiWithLength:NSSquai:eStatUsrte!iLLengthl retain]; 

HSImge * status Image - [NSImage iinag.eNajiied:i&"TheZ.tlff*] : 
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[myStatusItem eetlioage: status Image]: 

[myStatusItem setHighlightMode:¥ES]: 

[myStatuBltem setHenuimyStatusMeTiu]; 

[myMenuStatusItem setTitleiNSLocalizedStrlngSpecial 
Status"* ©"status menu item text**)I: 

] 

©end 

Hie first thing to notice in this code block ls that NSStatuslteni 
objects are not initialized directly. Ratlierj the>^ are requested from 
an NSStaaisBar object. The NSStamsBar object has a class level 
method tliat returns the system status bar from which I one can 
request a NSStamsItem. 

Once 1 hkive my newtlie NSStatuslteni request is complete, it 
is possiblel am able to set its image, highlight mode and menu. Tlie 
image is the image tltat is displayed on the 
Menu Bar and is has a l6xl6 re^solutionimage. 

Tlie highlight mcxle detennines whether or 
not ilie image is higlilighted when clicked. 

Tlie default is “NO”, which is not appropriate 
when a menu is attached so 1 have set it to 
YES in die sample code. The last call to 
myStatusltem passes it the menu tliat isl 
constructed and referenced in Interface 
Builder This will be tlie menu that the 
NSStatiisItem displays when it is clicked. 


The last line of the applicationDldEinisliIaundiing: method is 
a call to the status menu item that isl referenced from Interface 
Builder. Hiis call changes tlie text of tliat menu item. Note that the 
sample CTde doesi have not disabled tliis menu. Since it does not 
liave a taiget or action it will be displayed grayed out already so 
there is no need to disable it. 

Controlling The Menu 

In various situations it is appropriate to make changes to the 
NSStamsItem or one of iLs menu items. In this example, J have 
intentionally linked the *myStatusMenuItem ivar to one of the 
NSMenuItem objects on die menu so that it can be changed during 
the life of die program. To illustraLe diis change, 1 added a button 
to tlie niiiin window that when clicked would cliange tills menu 
item: 

nIc A uiArI ii£t r II 3L ^^^iii..dLi.iui i 



About 

Quit 


Status Menu 


mySiatiii s Me n ulte r tn 




AppOelcgatc 

Image 3; Unking the AppDelegate to the Menu 



TeghRestore 

help is on the way 


Mobile Electronics Repairs S Upgrades 

Overnight - Nationwide 

• Local Pickup & Delivery 

• Fast Friendly SeruicB 

■ PO OO+'Lccal Drop-Off Lo catloris 



1-888-64-RESTORE 

tl-Saa-647 3786) 
Sam-5pm PST M-F 

techrestore.com 



Put A Smife On Your Client's Face 
By Referring Them To The Nation’s 
Most Recommended Repair Service 

Laptops • iPods • PSPs • Apple TVs 
Repairs/Upgrades/Data Recovery 

• Affiliate Commissions 

• Reseller Accounts 

■ Volume Parts Sales 

• Blind Drop Shipments 

• Transparent Back-End Repairs 

• Customer Referral Numbers 


Outsource Repairs, 
Increase Profits! 

www.techrestore.com/reseller 



America’s Most Trusted 
Repair Service Now Offers 
Over SOOO Local Drop Off 
Locations With America's 
Most Trusted Carrier 


FecCx Kinko's* 

Office and Pnr>t Cen^r 


Shop for Mac Laptops, 
Apple TVs fi Mobile 


Electronics Accessories 



sKmlce mirks used try perrmulon 

























IT TRAINING 


IT CERTIFICATION 


APPLE PRO APRS 


AppOeUgateM 

- (lEAction)changeMenu:(id)sender: 

AppDelegate.m 

- (iBActiori) nhangeMenu: (id) sender; 

[ 

[myMenuStatusItem s&tTitle:NSLocalizedStrlng(©^Changed 
Status", statue menu item changed text")]; 

) 

With this addition to the application^ the status menu item 
will change to "Changed StatusT 

ft is also p(;ssible to change the image that is displayed on 
the Menu Bar 

AppDelegate.h 

-(iBActian)purpleZ:(id)sender; 

-(IBActiQn)blackZ:(id)sender; 

AppDelegate.m 

- (IBAction)purplaZ:(id)sender; 
i 

[myStatusItem setimage;[NSImage 
imageWamed:@"ThePurpleZ.tiff"]]: 

1 

-(iBAction)blackZ:(id)sender; 
f 

[myStatusTtera setlmage: [NSIniage 
imageNanied:@"TbeZ, tiff] ] : 

1 

In the example application, 1 added these actions are 
added to the Format menu rather than burtons on the main 
window. 

Lastly, if it is desired to have tlie NSStatusltem as an option 
rather than a requirement in die application, it is possible to 
remove the menu item from the bar: 

AppDelegate.h 

- (TBActlon)removeStatusItem:(id)sender: 

■ (iBActlon)addStatusItein: (id)sender; 

AppDelegate.m 

- (IBAction)removeStatusItem:(id)sender; 

f 

[ [NSStatnsEar systemStatusBar] 
removeStatusItem;myStatusItem]; 
myStatusItem “ nil; 

[ 
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* (TBActioTT)addStatusItem: (id) sender; 

1 

if (myStatusItem) return; 

myStatusItem ^ [([NSStatusBar systemStatusBar] 
statusItemWlthLengthiNSVariahleStatusItemLength] retain]: 

[myStatusItem setimage:[NSimage 
imageNanied ; @"TheZ. tif f" ] ] : 

[myStatusItem setRighlightHodeiYES]: 

[myStatusItem setMenu;myStatusHenu]; 

[myMenuStatusItem setTitleiNSLocalizedString(©“Special 
Status", ©"status menu Item text")]: 
i 

-(BOOL)validateMenuItem:(NSMenuItem*)item 

( 

if ([item action] ©selector (reitioveStatusItem:}) f 
return (myStatusItem 1= nil); 

) 

if ([item action] = ©selector(addStatusItera:)) \ 
return (myStatusItem ^ nil); 

I 

return YES; 
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i 

The code to remove tlie status item is very simple. Just 
one call to NwS Status Bar -removeStaiusItem: and it is gone. 
Since there is no way to add the existing item back to die bar 
it is prudent to set the ivar to nil at this time. 

To add the NSStatusItem back to the bar^ the example I 
simply copiesd the code from the 
applicationDidFinishLaunching: method. Ideally tills should be 
abstracted so that the code is not duplicated. 

Lastly, 1 addedthere is a -validateMenuItem; metliod to 
make .sure that only one status item is ever added and just as 
importantly that the application is not trying to remove a non¬ 
existent item I do not try to remove a non-existent item. 

Now, with the addition of a checkbox in the preferences 
tinked to NSUserDefaults, it is trivial to add a user preference 
on whether or not to show^ the status item. One! could then 
add logic to the applicationDidFinishLaunching^ method to 
decide whetlier or not a NSStatusItem needs to be initiali^^ed 
Ixised on die NSUserDefault. 

Conclusion 

That is all diere is to the NSStatuslrejii API. Hopefully, one 
day, Apple will allow third party developers to utilize dieir 
internal status items so that we can legitimately produce menu 
liar items that are feature conipanihle to the system items. Until 
then, NSSiatusliem is a solid API that we can utilize. 

As a parting comment, if 1 wanted my entire application to 
run as a menu bar item (without a Dock icon ala Twitterifie), 
that only requires one small addition to die Info^plist: 
Info.plist 

<key >LSUIEIeinent< / key) 

<string)l</strir]g> 


Each subscriber receives 
faxes directly by email 
as PDF file attachments. 


Corporate accounts from 
3 to f 00+ users available 


For more information 
and a special offer for 
MacTech readers, visit 






© 


Call: 800-964-2793 


And the application will not bounce in the dock at all. I 
do not recommend that for this example application as it is not 
de.signed to run in that manner but there are plenty of 
applications that this is perfectly suited for 

NOTE: This change cannot be made to an application on 
the lly. So if you wanted to make the Dock icon optional also 
it wtiuld require an application restart and probably some 
trickery with the Finder as the Finder does tend to “cache” die 
Info.pilst file for applications. 
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A “fast” introduction to wiki and biog 
Server for the SysAdmin 


by Ben Greisler 


Wiki Wiki! 


‘^Quickf Quick!” Thai is the rough translation of 
“wiki wiki"* from the Hawaiian language, and we can 
thank Ward Cunningham for its inclusion in our daily 
lives. 

By providing a quick way for grc)up.s to 
collaborate, and individuals to speak out, wiki and blog 
technologies have grown in popularity very quickly, no 
pun intended. People liave found their voice and 
companies have found an effective way to provide 
communications amongst their employees. Apple has 
fed this need by providing wiki and blog ser\aces in 
Mac OS X 10.5 Server, We will take a look at these 
services, discuss some features and considerations for 
deployment. 
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Wiki Planning and Setup 



There are several prerequisites when setting up 
wiki and lilog services on Leopard Server: 

The first gotcha is that the machine hosting tlie service 
needs have a local OD Master running on it. Note, though, 
that the machine can also be connected to another directory^ 
service, too. 

You need to have a website set up to present your wiki 
info. Protect this site the same way you would any other .site, 
such as VPN-only access, or by using SSL. 

Plan your storage. As you may find your users storing a lot 
of data as attacliments to their blogs and wikis, make sure you 
have an appropriate amount of storage set aside. 

Each website can be enabled for wiki and blog services. In 
Server Admin, go to Web and then pick the site you wish to 
enable. From there you can chose which wiki and blog services 
you want to enable and if you want to restrict to certain 
individuals and groups. In Workgroup Manager, pick which 
Groups are to have wiki and blog services and enable them in 
the Basic tab. 


Fig. 1: Setting up wiki and blog services in Server Admin 
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Fig. 2; Enabling wiki services for a group 
in Workgroup Manager 
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File Locations 

Wiki content is stored in /Ubrary/Collaboration CdefaulO 
with tlie following specific locations: 

Group's services: 

/Library/ColIaborationyGraups/groupname/ 

Wiki page components: 

/Library/Collabcsratipn/Groups/grotipname/wiki/pagenaine* page/ 

Main text, himl content: 

/Library/Cellaboration/Groups/groupnaine/wiki/pagename. page/pa 
ge. htffll 


Metadata: 

/Library/Collaboration/Groups/groupnante/wiki/pagename.page/pa 
ge*plist 


Version history daialxise: 

/Library/Collaboration/Gronps/gronpnaitie/wiki/pagename. page/re 
visions.db 


Graphics: 

/Library/Cgllaboration/Gronpa/groupname/pagename.page/imagea/ 

Attachments: 

/Library / Coll abotatlon/Groups / group name/pagGnaine. page / attachm 
enta/ 


Wiki folder structure: 

# U -1 
total S 


drwxr-x-- 

2 

_teamsEerver 

_teamsserver 68 

Apr 

5 

16:56 

ArchivedGroups 

drwxr-x— 

3 

steamsserver 

_teamsserver 102 

Apr 

5 

16:59 

Groups 

drwxr-x— 

2 

_teaasserver 

_teamsserver 68 

Apr 

5 

16:56 

Users 

* rw-r-— 

1 

„teamsserver 

_teanisaerver 249 

Apr 

5 

16:56 

dataVersion.pllst 

# cd Groups/ 







f Is -1 
total 0 
d rwxr - x— 

10. 

_tearnsserver 

_teaiDsserver 340 

Apr 

5 

16:59 

wikigrpup 

# cd wikig 

1 roup/ 






Is -1 
total 24 
d rwxr-x— 

3 

_teamsserver 

_teamaserver 102 

Apr 

5 

16:59 

discussion 

-rw-r- 

1 

_teaiDsseryer 

_teamsseTVet5120 

Apr 

5 

16:59 

index,db 

d rwxr - x— 

2 

_team.s server 

_teamaserver 6B 

Apr 

5 

16:59 

mailing11St 

- rw-r“' 

1 

_t aamsserver 

_teamsserver 432 

Apr 

5 

16:59 

metadata.pllst 

drvxr'X-' 

2 

_tearnsserver 

_teaiiifi server 68 

Apr 

5 

16:59 

public 

drvxr-X-' 

2 

_teamsserver 

^teauiBserver 68 

Apr 

5 

16:59 

resources 

drwxr-x-- 

2 

_teainsserver 

_teamsserver 68 

Apr 

5 

16:59 

weblog 

drwxr-x-- 

3 

^teamsserver 

_teamsserver 102 

Apr 

5 

16:59 

wiki 

# cd wiki/ 







# Is -1 
total 0 
drwxr-x-- 

7 

_teantsservar 

_teamsserver 238 

Apr 

5 

16:39 

welcome.page 


f cd welcome^page/ 
# la -1 
total 32 


drwxrx-- 

2 

_tearnsserver 

_teamsserver 68 

Apr 

5 

16:59 

attachments 

drwxr-x— 

2 

_teantsserver 

_teainsserver 63 

Apr 

5 

16:59 

images 

- rw r- 

1 

steams server 

^teamsserver 427 

Apr 

5 

16:59 

page.html 

-rw - r^—' 

1 

steamsserver 

_tGamsserver 730 

Apr 

5 

16:59 

page-plist 

-rw^r—- 

1 

_teamsEerver 

_teamsflerver5120 

Apr 

5 

16:59 

revisions.d 


Blog content is stored in /Library/Collaboration (default) with the following specific locations: 


User’s blog: 

/Llbrary/Collaboration/Users/(username)/ 

Blog folder structure: 

# cd /Library/Collaboratlon/Uaers/ 

# Is -1 
total D 


drwxr-x— 

8 

_teamsEerver 

_teamsserver 272 

Apr 

5 

17:09 

wikiuser 1 

cd wlkiusei 
# Is -1 
total 24 
drwxr-x-” 2 

■1/ 

_teamBserver 

_teains server 68 

Apr 

5 

17:09 

discussion 

- rw-r- 

1 

_t eamsserver 

^teamsserverS120 

Apr 

5 

17:09 

index.db 

- rw' r^- 

1 

_tearasserver 

„teamsserver 479 

Apr 

5 

17:10 

metadata.plist 

d rwx r-X— 

1 

_teamsserver 

_teaiiisserver 68 

Apr 

5 

17:09 

public 

drwxr^x-- 

2 

_teamsserver 

_teamsserver 68 

Apr 

5 

17:09 

resources 

drwxr-x-- 

2 

_tearnsserver 

_teamsserver 68 

Apr 

5 

17:09 

weblog 
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Other files: 

Note: Tliese files may be overwritten during software updates 
and any modifications made in these directories might be nullified 
at that time. 

Client side code: 

/usr/share/collabo r ation/ 


Python code, help files, templates, etc: 

/usr/share/wikid/ 

Wiki and Blog Security 
and Control 

Being a web based teclinology, standard web security 
teciiniques can be used such as SSL. From tlie user control 
perspective you can control wiki access in tlie Web services Ik by 
placing the users and groups you want to aUow, You can also use 
Service Access Control Lists (SACLls) from witliin Server Admin to 
determine which users and groups may or may not get access to 
blogs. 

When enabling tlie group's access to web services in 
Wori<group JVLinger, yt^u need to pick wliich website hosts the 
desired wiki, and tlren set the pemiLssions for the group. There are 
pull-down menus for allowing who can edit the services and who 
can view then. Tire choices are: 


Group meml:>ers only, lliis will allow all users in die group 
access. 

Some group members. Only group members with editing 
privileges can edit, 

Autlientiaited users. Only users than can auihenticate against 
the directory service. 

Anyone. No authentication needed. 



Fig. 3: Turn on SSL in Web services in Server Admin 
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Fig. 4: Setting up a Service Access Control List 
for blogs in Server Admin 


Wiki Templates 

Apple provides a set of themes and templates to provide a 
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soft^^re update. It is also suggested to start with tlie wireframe 
template located at: 

/Library/Application/Support/Apple/WikiSstver/Themes/wireframe-w 
Uti theme/ 





Fig. 5: Setting up the default template, attachment size and 
data store in Web services in Server Admin 



Fig. 6: Default blog interface 
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Fig. 7; Default wiki interface 


Storage Considerations 

Blog and wiki entries can contain more than just texL 
You will find users placing pictures, video and audio into 
their posts. When you estimate your storage needs, also 
consider using some form of shared storage, such as Xsan2, 
if you will want some type of failover or redundant 
environment for hosting wiki and blog services. 

Active Directory Integration 
Considerations 

It is possible to use AD users with wiki and blogs, but 
due to the fact that the wdki server uses CR/yvl-MD5 
authentication, and the AD plug-in for Open Directory 
doesn’t, you need to allow clear text passwords for wikid. 
This would be the case if you have your wiki server bound 
to AD and running as an OD master. Keep in mind that to 
protect your users, you should be running SSL on the site 
hosting the wiki. 

To enable clear text passwords for wikid, use 

“serveradmin" to run the following commands: 
sudo serveradinin settings teams;enableClearTextAath = yes 
?eudq serveradmin stop teams 
?sudo aerveradmln start teams 

Additional Gotcha’s 

While Apache2 is the default w^ebserver in Leopard 
Server, it is possible to use Apache 1,3. If you choose to do 
this be aware that you shouldn’t use SSL, as it will produce 
pages with http:// rather than htipsi//. With SSL disabled 
you lose a front-line security defense. 

To disable blog service while maintaining wikis, go to 
Workgroup Manager (with Inspector enabled) and pick 
Groups from the pulldown menu. Find the ServicesLocator 
attribute and click the disclosure triangle. Delete the entry 
that ends with ^blog" and save the changes. 

Conclusion 

From my experience out in the field, whki and blog 
services, collaboration services in general, have really 
pushed the adoption of Leopard Server In the past I have 
found people hesitant to update their server OS early in the 
new OS cycle, but the collaboration services in Leopard 
have made people take the chance and become early 
adopters. 

There is more to be learned about wiki and blog 
services and it is maturing quickly. I have seen direct Apple 
responses in various lists and discussions and that indicates 
to me that Apple is taking wiki and blog services very 
seriously. We will see more development from Apple and 
third parties. 1 expect to see new templates become 
available from the aftermarket much like what we saw with 
Keynote. 
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macforge.net 

MacForge indexes and tracks open source 
projects that run on the Mac, or are likely to 
without further modification. Thanks to 
MacForge, there's no need to sift through ^ 
huge listings of open source that you can't 
use. With categories, filters, and more, 
MacForge makes it easy to find 
what you need. 

MacForge: 

Your Gateway to Mac Open Source 

www.macforge.net 

Sponsored by M/C1KH 


I also expect we will learn more about wiki and blog 
services, such as the tidbit 1 heard that you may not need to 
run it on a local OD Master, but simply doing a trusted bind 
between your wiki and blog 5er\^eT to an OD Master may he 
enough. I haven't tested it at the time of the writing of the 
article, but I expect it will work. 

Please provide your feedback to me so 1 may include it 
in future articles. You can send the feedback to: 
ben@kodimac.com 
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DVDxDV, 
DVDxDV Pro 

Converting DVD Media into 
fiies you can actuaiiy use! 

By Dennis Sellers 


If someone asks yon, “Wliat's tlie best way to gel media off a 
home-made DVD?’\ what's your aaswer? 'ffiandbrake” 
(http://hancibrake.fr/)? Hie free, open source muldtlireaded DVD 
to MPEG-4 ripper/convener is good, liut a little intiniidating for 
some. 

A l:)etter answer niiglit 'Try DVDxDV/' It’s an application 
that transforms DVDs into digital media that an he read by a Mac. 
Using DVDxDV, clips from various home movie DVDs can be 
brought together to make a new movie. 

Insert a DVD into your Mac, and you can use DVDxDV to 
preview it. You can extract tile entiie DVD or choose a part of the 
video to capture. Once captured, you am import the ftx>rage into 
any application that c-an read the QuickTime movie fomiat. 

Note that DVDxDV can't read DVDs that contain Content 
Scrambling System encryption, which includes most commercial 
DVDs. Sony, but you can’t insert Will Smith as a costar in your 
home movie. 

DVDxDV comes in two different versions: a US$25 consumer 
version and an $80 professional version. Ttie consumer version is 
for the home video enthusiast and allows DVD video to lie 
extracted from a DVD and imported into iMovie, Final Cut Express 
and iDVD. 

The pro version is designed for video professionals and 
allows Final Cut Pro and DVD Studio Pro users to extract liigh 
quality multi-channel audio from DVDs. Each individual channel 
in a sound track can be exponed to a separate 24-bit AIFF sound 
file. What's more, DVDxDV Pro lets you reverse the original 
interlaced field ordering of a DVD. (DVDxDV uses the same video 
extraction engine as DVDxDV Pro. but exports all audio to a 
stereo two channel mix.) 

DVDxDV can read a DVD in three ways. It will read an 
unencrypted DVD directly from your computer’s DVD-ROM drive. 
It can read a DVD that lias l>een copied to your Mac's liard drive. 
Or it can open an individual “.VOB" file. 

Using DVD’s pre\4ew^ functions, you can scrub through the 
video timeline and specify a scene to extraa by marking “in” and 
“out" points. Select the “New Movie” item from the “Extract” 
menu to extract the video clip. At this point, you're offered a list 
of presets, from which you c'an choose (depending on what you 



DVDxDV screen shot 

plan to do widi die extiacted video). You’ll also be asked to 
choose where you want the file saved. Then DVDxDV starts 
extracting die video. 

TIic extraction proces.s can take minutes or hours depending 
on how much kxitage you're grabbing and how much power your 
Mac packs. DVDxDV can preserve the nadve interlaced format of 
llie DVD. In the pro version, the interlace field order can btf: 
changed to lower field or upper field doniirumt. 

DVDxDV can automalically break a movie file up into 
chunks. For ex^impte, the iMovie export setting splits a movie into 
segments that are small enough to he imported into iMovie. 

One use of the appliaition Ls to save space on your Mac's hard 
drive. Video footage consumes storage re-sc^urces rapidly and most 
people bum their home movies to D\D. However, there are times 
you may find that you want fooUige already erased from a hard 
drive to insert into a new film masterpiece. With DVDxDV, you can 
find the DVD that has the particular video clip you want, insert the 
DVD into you Mac and am DVDxDV to grab the fcx)tage you want. 

You can also use the software to, for instance, grab the entire 
contents of a DVD, add extra titles, more music, etc, In other 
words, you can go back and do a “Director’s Cut" of that DVD you 
made weeks, months or years ago. 

Both the standard and pro vei^ions have recently been 
updated for Mac OS X 10.5 OLeopard”) compatibility. DVDxDV 
Pro can now can resize 16:9 and 2,35:1 anamorphic video so it 
displays correctly on an iPod or iPhone screen and can direct 
export from DVD to Apple TV. 

Botli versions of DVDxDV require Mac OS X 10.3^9 or higher 
and QuickTime 7.0.3 or later. 

URL: http://WWW. dvdxdv. com /NewFolderLookS ile/Products/ 
DVDxDVoverview. htm 

i\i\ 


About The Author 

Deim Severs a a long time jomoBsf. He started m tiie aewqieper 
bo^ss, bat has been in the oiAie fourm^an business for the past 
15 years. He's the e^tor/pfMdier of ll/lacsittim News 
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Now scheduling 
and contact 
management 

for your entire | 
organization. | 



Now I Up to Date' and Contact'5 

Calendar and Contact Software for Business, Groups, Families and You, 



New 

SOFTWARE 


Phone: 866-527-0556 

Web: WWW. n o wsoBwa re xo m 


Is this project on schedule? When are you available to meet about the systems 
upgrade? Where are all the Field techs today? When was the lost time onyone talked 
to our biggest customer? 

Virtually all groups live (or die) by their abilities to meet deadlines and keep trock of 
their customers, prospects, and vendors. Few small companies or even departments 
of big companies have the tools they need. 

Now Up’to-Dote & Contact might just be the calendar and contact software for you. 
It's time-tested and used by more Mac-bosed companies than any other solution. And 
it's cross-ptotform-available for your PC users, too. It's easy to install and manoge and 
simple for your employees to understand and use. 

Using Now Up-toDate & Contact you con schedule meetings for multiple users, view 
multiple, simultaneous calendars, and reserve rooms ond resources. You can share 
contact information about your customers, prospects and vendors. And using our free 
server software you can set it up in minutes and share with users in the office or from 
anywhere with an internet connection. 


Coil us now Qt 866-527^556 or email us at mactech@nowsoftware,com 
and we^ll send you our free evoluotion kit, including the book that will 
make it oil easy, 'Take Control of Now Up-to-Date & Gontoct" from 
Take Control booksl 


Copyfilgh^ © 2006 Mow Soflwore, Inc. All rigkj reservied. Mow Up-Sp-Dqle ond Now Contsjd are negisterad I'radBmdffcs of Now Software, Inc Mac and Ihe Moc logo frademarks of Apple Ccrnip-u+ef, Enc., 
registered in the U-S- ond olher countries- All other trademarks acknowledged. 
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OmniGraffle 
Professional 5 

By Dennis Sellers 


If you’re having problems with a design project, don't 
grapple with it: Graffle it. OmniGraffle, that Ls. The Mac OS 
X diagramming application from the Omni Group was 
recently updated to version 5^0, adding Mac OS X 10.5 
(“Leopard”) compatibility, faster layout speed and new 
automatic layout options thanks to the addition of the 
Graphviz layout engine. 

OmniGraffle lets you 
drag and drop to create 
flow charts, org charts, 
network diagrams, family 
trees, project processes, 
office layouts-pretty 
much anything you can 
think of that can be 
represented by symbols 
and lines. The Leopard 
compatibility in version 
5.0 means that, among 
other things, OmniGraffle 
Pro supports Mac OS X 
10.5's Quick Look 
preview feature. With 
Leopard'S Quick Look, 
you can view the 
contents of a file without 
even opening it. In other 
words, like many other 
file types, you can look 
at OmniGraffle Pro 5 files 
in Leopard even if the 
Omni Group software 
isn’t open. 

In the latest version 
several of the standard 
OmniGraffle tools have 
been beefed up, 
including the line tools. 

OmniGraffle 5 includes 
Bezier lines, so you can 
create custom shapes 
with lines made up of curves, straight lines, and control 
points. The new version also adds a '‘mini inspector” that 
makes the most common inspector controls more 


accessible. You can change object size, location, fill, stroke 
and other key attributes right at the top of a document 
window. 

The latest version of OmniGraffle offers support for 
multiple page (“canvas”) documents. You can choose, add, 
duplicate, and remove canvases using the status bar or the 
Canvases inspector. Both the status bar and the Canva.s 
inspector depict the various canvases in icon mode; this lets 
you see which shapes are on which canvases. Canvases can 
be different sizes, and can be rotated 90 degrees when 
printed. You can mix landscape and portrait modes. 

Outlining has been enhanced in OmniGraffle Pro 5. 
There’s improved integration with the Omni Group’s 
OmniOutliner, which-as you can probably guess from the 
name-is a tool for creating, collecting and organizing 
information. You can use OmniGraffle's outline styles as 
filters if you import OmniOutliner documents, by mapping 

styles to your 
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OmniOutliner document 
structure. When you 
enter text information in 
OmniGraffle's Outline 
view, the graphical 
objects that are created 
can be styled and 
restyled in a variety of 
ways. The software can 
even associate a 
different style with each 
level in your outline. 

OmniGraffle Pro 5 
has improved import 
and export options. For 
example, a vector PICT 
export format is now 
available, OmniGraffle 
can both copy as vector 
PICT and export to that 
format; this makes it 
easier to do things such 
as copy and paste 
between OmniGraffle 
diagrams and 

applications .such as 
Microsoft Word or 
PowerPoint. Hyperlinks 
are supported on export 
to PDF, as is exporting 
files with multiple 
canvases as a single, 
multiple-page PDF file. 

With Smart Guides, when you move a shape, distance 
markers pop up and tell you when your new shape is going 
to form an equally-spaced row or column with any other 
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The Missing Sync" 



Reliable Handheld Synchronization for Mac 


Thanks to The Missing Sync, Mac users are no longer second-class citizens when it comes to keeping their 
mobile devices in sync. Whether it's a Windows Mobile 6 device, a BlackBerry or even a Palm Treo, there’s a 
Missing Sync product made to connect and synchronize that device with Mac OS X. 


Syncs Contacts, Calendars, Tasks 

• Supports Address Book, iCal, 
Microsoft Entourage 2004 

• Outstanding field support, even 
syncs Address Book contact photos 

• Supports calendar event reminders 
and detached events 

• Sync Services-savvy for syncing 
with third-party apps 


Complete Notes Syncronization 

• Includes Mark/Space Notebook for 
Mac to create, edit, categorize, sort 
and search through notes 

• Also supports Microsoft Entourage 
2004 and Bare Bones Yojimbo 

• Full support for Sync Services and 
.Mac syncing between Macs 


I Photo and ITlines Integration 

• Imports photos and videos from 
mobile devices into iPhoto albums 
or folders in the Finder 

• Resizes and downloads selected 
i Photo albums to the device for 
handheld viewing and slideshows 

• Downloads DRM-free music and 
podcasts for mobile playback 


The Missing Sync for BlackBerry, Palm OS or Windows Mobile is available in single-user licenses for $39.95 
or in multi-user packs for any size organization, The Missing Sync family of products provide a Mac-centric 
synchronization solution second to none. 


Visit www.markspace.com/reliable today to see how easy it is 
to sync the latest smartphones and mobile devices with the Mac. 
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domim 


Register 


Get your .COM 
or any other 
domain name 
here! 

FREE with every domain: 

starter Web Page 
Getting Started Guide 
Complete Email 
Change of Registration 
Parked Page w/ Domain 
Domain Name Locking 
Status Alert 
Total DNS Control 


hi' 


Just visit 

I www.mactechdomains.com 
to register for your domain today! 


shapes. The Automatic Layout inspector rearranges your 
diagram according to rules you specify. For example, you 
can choose “hierarchicar to lay out your document in the 
familiar “tree" format. Force-directed, radial, and circular 
layout styles are also available. 

With its updated Vlsio compatibility, OmniGraffle 
Professional 5 can import Microsoft Visio VSD files directly 
with continued support for import and export of Visio XML 
files, as well as import of Visio stencils and templates. In 
fact, this feature works so well you may consider leaving 
Visio behind entirely. 

OmniGraffle Pro has manual guides to help you in 
laying out your drawings. Guides can be dragged out onto 
your canvas From the top, bottom, or side; the shapes snap 
to the guides that you place. 

OmniGraffle has a large community of users that 
develop and share free stencils. Version 5-0 of the software 
has new local and online search capabilities in the stencil 
window that makes it simpler to search, organize and 
download these stencils. You can retool the shapes from the 
office layout stencil, as well as stretch and rotate an existing 
graphic with one of the shape tools. Also, OmniGraffle Pro 
5 offers the ability to search Graffletopia, a third-party 
library of free OmniGraffle stencils. 

Overall improvements in version 5 have made the 
process of drawing and creating in OmniGraffle easier and 
more intuitive than ever. Anyone who has to diagram 
anytliing-from a process chart to a web site mock- 
up-should download the OmniGraffle 5 demo and see 
exactly what the software has to offer. 

OmniGraflle 5 costs US $99-95. Upgrades from 
OmniGraffle 4 are available for $39.95, OmniGraffle 
Professional 5 1^5 available for $199^95 with upgrades from 
OmniGraffle Professional 4 costing $74.95. 

Available from www.omnigroup.com 
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Get MacTech delivered to 
your door at a price FAR 
BELOW the newstand price. 
And, it’s RISK FREE! 
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Matt Giger 

Lunar Software 

http;//www.eartfibrows 0 r.com 
What do you do? 

I am president of Lunar Software, vvhieh sells a software 
product called BanJiBroWsSer. f run the whole show^ from 
programming to web design, technical support and server 
administration. 

How long have you been doing what you do? 

I have been selling EarthBrowser full time since 199H, but 
rVe been jirogramming Macs since 19S(} where we liad souped 
up Macs widi 512K of memors’. 

Your first computer: 

A Yic-20 that kept my lap w'arm on many cold mornings. 
What’s the coolest thing about the Mac’ 

Stability and access to the Darwin command line is 
pRjbalily the be.st thing about Mac OS X right now, but Vd have 
to say that over the years the thing that has i>een eonslstendy 
superior about die Mac is the quality of text rendering. It puts 
every other operating system to shame. 

What advice would you give to people trying to enter this 
field? 



anyone to embed a 30 globe directly on ihefr website to 
display their own geo-content (even KMl fi1e.s). 

1 blog about niy EarthBrowser work at 
htip://blog.earth browser, com 

If yao Of someone yon know belongs m the MmTedi SpotS^t kt us 
know! Senddetdlsto editoriul@mac!fodiat)m 



Never be afraid of learning a new tiling, ncy matter how 
daunting, just take ir one step at a time. Always he learning 
something new. 

What’s the coolest tech thing youVe done using OS X? 

Tve got a mothballed version of EarthBrowser that uses 
OpenGL to render shaded relief mountaim and the solar 
system based on a C+H-Zl^ydion game engine with an 
embedded database. ^ 

Ever? 

Probably the coolest code 1 ever wrote was 
a library that can do colorspace JT 

transformation and geograpliic re-projection M ^ 

of almost any gecj-referenced dataset using M ^ |!ll 

various resampling kernels. W & K 

Where can we see a sample of your m ^ 
work? M M 

hHp://www.6arthbrowser.com W H 

The next way I’m going to impaa / ^ 

rr/OS X/the Mac universe is: jf 

EarthBrowser 3.fl is written f • B 

using Adobe Flash technology and I I 1 

will be Rdeasing a Java-scripr API m f ^ ^ 

the next few weeks, Tliis will allow t I \ 






Bundles for every Mac. 


all Macs I all the time 


We feature exclusive bundles on every Mac we sell-all the time. Sure, the specials 
will vary, but many include extra RAM, AppleCane, printer rebates and free shipping to 
offer substantial savings to you over pricing separately. 

Plus, every order outside of Vermont is always tax-free, and our friendly, knowledge¬ 
able staff is always ready to help with any question you may have. 

Visit Smalldog.com/specials to find your new Mad 























Vtoof potentiaL Our passion.* 


HBcrosoft 



Work together. Different machines? Different platforms? No matter. You can all speak the same language. 


\rJgyk 2001 ocpm 


Office: mac 














